Skip to main content
POST
Allow a wallet address for an offer

Authorizations

Authorization
string
header
required

OAuth 2.0 authorization and token endpoints

Path Parameters

offer_id
string
required

The ID of the offer

Body

Allow wallet params

Verifies wallet ownership via a previously generated challenge, then checks if the wallet is already allowed for the offer. If already allowed, returns 200 with an empty JSON object. Otherwise starts the supplier verification process and returns an encoded transaction to broadcast.

chain
enum<string>
required

The blockchain network the wallet belongs to.

Available options:
ethereum_sepolia,
base_sepolia,
solana_devnet,
ethereum_mainnet,
base_mainnet,
solana_mainnet
Example:

"ethereum_sepolia"

signature
string
required

The cryptographic signature of the challenge message.

Example:

"0xdeadbeef"

wallet_address
string
required

The wallet address to verify. For EVM chains, must be a valid Ethereum address (normalized to lowercase).

Example:

"0x742d35cc6634c0532925a3b844bc9e7595f0beb1"

Response

Successful response.

action
enum<string>
required
Available options:
broadcast_transaction
data
string
required

The encoded transaction to broadcast on-chain to complete wallet allowlisting.

to
string
required

The contract address to submit the transaction to.