Wallet adapter settings

Wallet adapter settings define how OpenPoly talks to operator wallet system.

Core decisions

• adapter type: simulator or rest_v1
• operator currency code
• operator-hosted callback paths
• auth secret or token strategy
• optional signature secret
• timeout expectation

Simulator mode

Use only for staging drills and onboarding.

• no real wallet movement
• simulator operator API endpoints become available
• useful for launch, trade, webhook, and idempotency validation

REST v1 mode

Use for real operator-hosted wallet integration.

Expected operator-hosted paths:

• /balance
• /debit
• /credit
• /debit-reversal
• /operation/{idempotency_key}

Full contract: /docs/wallet-adapter/overview

Required backend behavior

• every mutation uses idempotency key
• lookup endpoint can resolve ambiguous mutations
• timeout or unknown result must be recoverable through lookup
• currency code must stay consistent with operator config

Secret handling

• store outbound auth secret in operator secret manager
• store optional signing secret separately
• never paste live secrets into tickets or chat

Timeout guidance

REST v1 adapter default timeout is 10000 ms.

If operator wallet may exceed timeout, implement fast accept plus durable processing, or ensure lookup endpoint can resolve unknown state safely.

Common misconfigurations

• wrong currency code
• missing lookup endpoint
• non-idempotent debit or credit handling
• signature secret mismatch
• simulator left enabled when real wallet expected