Agentic Commerce

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "offerId",
    "configId",
    "signerAddress"
  ],
  "properties": {
    "offerId": {
      "type": "string",
      "description": "ID of a buyer-initiated offer (creator='BUYER') to commit to. The seller fulfils the offer."
    },
    "configId": {
      "type": "string",
      "description": "Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid values for this server."
    },
    "royaltyInfo": {
      "type": "object",
      "required": [
        "recipients",
        "bps"
      ],
      "properties": {
        "bps": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "minItems": 0,
          "description": "Royalty amounts per recipient in basis points (1 bp = 0.01%). Parallel to recipients. Total must not exceed 10000."
        },
        "recipients": {
          "type": "array",
          "items": {
            "type": "string",
            "description": "Valid Ethereum address (e.g. '0xAbCd...' or '0xabcd...'). Mixed-case addresses are checksum-validated; all-lowercase and all-uppercase addresses are also accepted."
          },
          "minItems": 0,
          "description": "Array of addresses receiving resale royalties."
        }
      },
      "additionalProperties": false
    },
    "executionMode": {
      "enum": [
        "direct",
        "metaTx"
      ],
      "type": "string",
      "description": "'direct' = standard on-chain tx (sign locally with your wallet → send_signed_transaction). 'metaTx' = gasless relay via Biconomy (send_meta_transaction). Defaults to 'direct'."
    },
    "signerAddress": {
      "$ref": "#/properties/royaltyInfo/properties/recipients/items",
      "description": "Ethereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally."
    },
    "collectionIndex": {
      "$ref": "#/properties/offerId"
    },
    "drMutualizerAddress": {
      "$ref": "#/properties/royaltyInfo/properties/recipients/items",
      "description": "Valid Ethereum address (e.g. '0xAbCd...' or '0xabcd...'). Mixed-case addresses are checksum-validated; all-lowercase and all-uppercase addresses are also accepted."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "offerId",
    "tokenId",
    "configId",
    "signerAddress"
  ],
  "properties": {
    "buyer": {
      "type": "string",
      "description": "Optional buyer address if different from signerAddress. When set, executionMode must be 'direct'."
    },
    "offerId": {
      "type": "string",
      "description": "ID of a conditional (token-gated) offer to commit to. Caller must hold the gating token specified by the offer's condition."
    },
    "tokenId": {
      "$ref": "#/properties/offerId",
      "description": "Token ID of the gate token used to qualify for the conditional commit (relevant for ERC-721/1155 and TokenRange gating)."
    },
    "configId": {
      "type": "string",
      "description": "Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid values for this server."
    },
    "executionMode": {
      "enum": [
        "direct",
        "metaTx"
      ],
      "type": "string",
      "description": "'direct' = standard on-chain tx (sign locally with your wallet → send_signed_transaction). 'metaTx' = gasless relay via Biconomy (send_meta_transaction). Defaults to 'direct'."
    },
    "signerAddress": {
      "$ref": "#/properties/buyer",
      "description": "Ethereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "metadataUri",
    "metadataHash",
    "price",
    "sellerDeposit",
    "buyerCancellationPenalty",
    "quantityAvailable",
    "validFromDateInMS",
    "validUntilDateInMS",
    "voucherRedeemableFromDateInMS",
    "voucherRedeemableUntilDateInMS",
    "disputePeriodDurationInMS",
    "voucherValidDurationInMS",
    "resolutionPeriodDurationInMS",
    "configId",
    "signerAddress"
  ],
  "properties": {
    "price": {
      "type": "string",
      "description": "Offer price in the exchange token's smallest unit (wei). Pass as string to avoid precision loss, e.g. '1000000000000000000' = 1 ETH."
    },
    "agentId": {
      "$ref": "#/properties/price",
      "description": "Optional dACP agent facilitating this offer. Omit or pass '0' if no agent."
    },
    "creator": {
      "enum": [
        "SELLER",
        "BUYER"
      ],
      "type": "string",
      "description": "'SELLER' (default) = seller creates offer. 'BUYER' = buyer-initiated offer, quantity must be 1."
    },
    "configId": {
      "type": "string",
      "description": "Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid values for this server."
    },
    "feeLimit": {
      "$ref": "#/properties/agentId",
      "description": "Max protocol fee the seller accepts in same token unit. Pass as string."
    },
    "priceType": {
      "type": "number",
      "description": "0 = static price, 1 = discovery price (auction)."
    },
    "metadataUri": {
      "type": "string",
      "description": "IPFS URI pointing to the offer metadata JSON. Obtain by calling store_product_v1_metadata, store_bundle_metadata, or store_base_metadata."
    },
    "royaltyInfo": {
      "type": "object",
      "required": [
        "recipients",
        "bps"
      ],
      "properties": {
        "bps": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "minItems": 0,
          "description": "Royalty amounts per recipient in basis points (1 bp = 0.01%). Parallel to recipients. Total must not exceed 10000."
        },
        "recipients": {
          "type": "array",
          "items": {
            "$ref": "#/properties/exchangeTokenAddress"
          },
          "minItems": 0,
          "description": "Array of addresses receiving resale royalties."
        }
      },
      "additionalProperties": false
    },
    "metadataHash": {
      "type": "string",
      "description": "Keccak256 hash of the metadata JSON. Returned alongside metadataUri from the store_*_metadata tools."
    },
    "executionMode": {
      "enum": [
        "direct",
        "metaTx"
      ],
      "type": "string",
      "description": "'direct' = standard on-chain tx (sign locally with your wallet → send_signed_transaction). 'metaTx' = gasless relay via Biconomy (send_meta_transaction). Defaults to 'direct'."
    },
    "sellerDeposit": {
      "$ref": "#/properties/price",
      "description": "Seller collateral in same unit as price. Released to seller on completion or forfeited on dispute. Pass as string."
    },
    "signerAddress": {
      "$ref": "#/properties/exchangeTokenAddress",
      "description": "Ethereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally."
    },
    "collectionIndex": {
      "$ref": "#/properties/agentId",
      "description": "Index of the seller's NFT collection for vouchers. Omit to use default (index 0)."
    },
    "disputeResolverId": {
      "type": "string",
      "description": "ID of the dispute resolver for escalated disputes. Call get_dispute_resolvers to list available resolvers."
    },
    "quantityAvailable": {
      "type": "number",
      "description": "How many times this offer can be committed to. Must be 1 when creator='BUYER'.",
      "exclusiveMinimum": 0
    },
    "validFromDateInMS": {
      "type": "number",
      "description": "Unix timestamp in milliseconds when the offer becomes active. Example: Date.now() for immediate."
    },
    "validUntilDateInMS": {
      "type": "number",
      "description": "Unix timestamp in milliseconds when the offer can no longer be committed to."
    },
    "drMutualizerAddress": {
      "$ref": "#/properties/exchangeTokenAddress",
      "description": "Optional dispute resolver mutualizer contract address that pools resolution funds."
    },
    "exchangeTokenAddress": {
      "type": "string",
      "description": "ERC-20 token accepted for payment. Omit or use address(0) for native ETH. Call get_supported_tokens for valid values."
    },
    "buyerCancellationPenalty": {
      "$ref": "#/properties/price",
      "description": "Amount buyer forfeits on cancel, in same unit as price. Must be <= price. Pass as string."
    },
    "voucherValidDurationInMS": {
      "type": "number",
      "description": "Voucher is redeemable for this many ms after commit. Set to 0 to use voucherRedeemableUntilDateInMS instead."
    },
    "disputePeriodDurationInMS": {
      "type": "number",
      "description": "Duration in ms for buyer to raise a dispute after redeeming. Example: 604800000 = 7 days."
    },
    "resolutionPeriodDurationInMS": {
      "type": "number",
      "description": "Duration in ms to respond to a resolution proposal before it expires. Example: 259200000 = 3 days."
    },
    "voucherRedeemableFromDateInMS": {
      "type": "number",
      "description": "Timestamp in ms from which buyer can redeem. Must be >= validFromDateInMS."
    },
    "voucherRedeemableUntilDateInMS": {
      "type": "number",
      "description": "Timestamp in ms after which voucher cannot be redeemed. Set to 0 to use voucherValidDurationInMS instead."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "signature",
    "offerCreator",
    "committer",
    "sellerId",
    "buyerId",
    "metadataUri",
    "metadataHash",
    "price",
    "sellerDeposit",
    "buyerCancellationPenalty",
    "quantityAvailable",
    "validFromDateInMS",
    "validUntilDateInMS",
    "voucherRedeemableFromDateInMS",
    "voucherRedeemableUntilDateInMS",
    "disputePeriodDurationInMS",
    "voucherValidDurationInMS",
    "resolutionPeriodDurationInMS",
    "configId",
    "signerAddress"
  ],
  "properties": {
    "price": {
      "$ref": "#/properties/collectionIndex",
      "description": "Offer price in the exchange token's smallest unit (wei). Pass as string to avoid precision loss, e.g. '1000000000000000000' = 1 ETH."
    },
    "agentId": {
      "$ref": "#/properties/collectionIndex",
      "description": "Optional dACP agent facilitating this offer. Omit or pass '0' if no agent."
    },
    "buyerId": {
      "$ref": "#/properties/collectionIndex",
      "description": "Numeric ID of the buyer entity. Use '0' for seller-initiated offers."
    },
    "creator": {
      "enum": [
        "SELLER",
        "BUYER"
      ],
      "type": "string",
      "description": "'SELLER' (default) = seller creates offer. 'BUYER' = buyer-initiated offer, quantity must be 1."
    },
    "configId": {
      "type": "string",
      "description": "Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid values for this server."
    },
    "feeLimit": {
      "$ref": "#/properties/collectionIndex",
      "description": "Max protocol fee the seller accepts in same token unit. Pass as string."
    },
    "sellerId": {
      "$ref": "#/properties/collectionIndex",
      "description": "Numeric ID of the seller entity. Obtain via get_sellers_by_address."
    },
    "committer": {
      "$ref": "#/properties/offerCreator",
      "description": "Ethereum address of the buyer committing in the same transaction."
    },
    "condition": {
      "type": "object",
      "required": [
        "method",
        "tokenType",
        "tokenAddress",
        "gatingType",
        "minTokenId",
        "maxTokenId",
        "threshold",
        "maxCommits"
      ],
      "properties": {
        "method": {
          "type": "number",
          "description": "Gating method: 0=None, 1=Threshold (hold >= threshold tokens), 2=SpecificToken (hold specific token ID)."
        },
        "threshold": {
          "$ref": "#/properties/collectionIndex",
          "description": "Minimum token balance required. Pass as string."
        },
        "tokenType": {
          "type": "number",
          "description": "Token standard: 0=ERC-20, 1=ERC-721, 2=ERC-1155."
        },
        "gatingType": {
          "type": "number",
          "description": "0=PerAddress (each address commits once), 1=PerTokenId (each token ID can be used once)."
        },
        "maxCommits": {
          "$ref": "#/properties/collectionIndex",
          "description": "Max commits per qualifying address or token ID. Pass as string."
        },
        "maxTokenId": {
          "$ref": "#/properties/collectionIndex",
          "description": "Max token ID (inclusive) for ERC-721/1155 criteria. Pass as string."
        },
        "minTokenId": {
          "$ref": "#/properties/collectionIndex",
          "description": "Min token ID (inclusive) for ERC-721/1155 criteria. Pass as string."
        },
        "tokenAddress": {
          "$ref": "#/properties/offerCreator",
          "description": "Address of the gate token contract buyers must hold."
        }
      },
      "additionalProperties": false
    },
    "priceType": {
      "type": "number",
      "description": "0 = static price, 1 = discovery price (auction)."
    },
    "signature": {
      "type": "string",
      "description": "ECDSA signature over the offer typed data. Workflow: sign_full_offer → sign the returned typed data locally with your wallet (EIP-712) → use result here."
    },
    "metadataUri": {
      "type": "string",
      "description": "IPFS URI pointing to the offer metadata JSON. Obtain by calling store_product_v1_metadata, store_bundle_metadata, or store_base_metadata."
    },
    "royaltyInfo": {
      "type": "object",
      "required": [
        "recipients",
        "bps"
      ],
      "properties": {
        "bps": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "minItems": 0,
          "description": "Royalty amounts per recipient in basis points (1 bp = 0.01%). Parallel to recipients. Total must not exceed 10000."
        },
        "recipients": {
          "type": "array",
          "items": {
            "$ref": "#/properties/offerCreator",
            "description": "Valid Ethereum address (e.g. '0xAbCd...' or '0xabcd...'). Mixed-case addresses are checksum-validated; all-lowercase and all-uppercase addresses are also accepted."
          },
          "minItems": 0,
          "description": "Array of addresses receiving resale royalties."
        }
      },
      "additionalProperties": false
    },
    "metadataHash": {
      "type": "string",
      "description": "Keccak256 hash of the metadata JSON. Returned alongside metadataUri from the store_*_metadata tools."
    },
    "offerCreator": {
      "type": "string",
      "description": "Ethereum address of the seller creating this non-listed offer. Must match the seller's assistant address."
    },
    "executionMode": {
      "enum": [
        "direct",
        "metaTx"
      ],
      "type": "string",
      "description": "'direct' = standard on-chain tx (sign locally with your wallet → send_signed_transaction). 'metaTx' = gasless relay via Biconomy (send_meta_transaction). Defaults to 'direct'."
    },
    "sellerDeposit": {
      "$ref": "#/properties/collectionIndex",
      "description": "Seller collateral in same unit as price. Released to seller on completion or forfeited on dispute. Pass as string."
    },
    "signerAddress": {
      "$ref": "#/properties/offerCreator",
      "description": "Ethereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally."
    },
    "collectionIndex": {
      "type": "string",
      "description": "Index of the seller's NFT collection for vouchers. Omit to use default (index 0)."
    },
    "disputeResolverId": {
      "type": "string",
      "description": "ID of the dispute resolver for escalated disputes. Call get_dispute_resolvers to list available resolvers."
    },
    "quantityAvailable": {
      "type": "number",
      "description": "How many times this offer can be committed to. Must be 1 when creator='BUYER'.",
      "exclusiveMinimum": 0
    },
    "useDepositedFunds": {
      "type": "boolean",
      "description": "If true, use funds already deposited in the protocol treasury instead of transferring from the wallet."
    },
    "validFromDateInMS": {
      "type": "number",
      "description": "Unix timestamp in milliseconds when the offer becomes active. Example: Date.now() for immediate."
    },
    "conditionalTokenId": {
      "$ref": "#/properties/collectionIndex",
      "description": "Optional token ID of the NFT gate token used by this specific commit (for SpecificToken gating type)."
    },
    "validUntilDateInMS": {
      "type": "number",
      "description": "Unix timestamp in milliseconds when the offer can no longer be committed to."
    },
    "drMutualizerAddress": {
      "$ref": "#/properties/royaltyInfo/properties/recipients/items",
      "description": "Optional dispute resolver mutualizer contract address that pools resolution funds."
    },
    "exchangeTokenAddress": {
      "$ref": "#/properties/royaltyInfo/properties/recipients/items",
      "description": "ERC-20 token accepted for payment. Omit or use address(0) for native ETH. Call get_supported_tokens for valid values."
    },
    "buyerCancellationPenalty": {
      "$ref": "#/properties/collectionIndex",
      "description": "Amount buyer forfeits on cancel, in same unit as price. Must be <= price. Pass as string."
    },
    "voucherValidDurationInMS": {
      "type": "number",
      "description": "Voucher is redeemable for this many ms after commit. Set to 0 to use voucherRedeemableUntilDateInMS instead."
    },
    "disputePeriodDurationInMS": {
      "type": "number",
      "description": "Duration in ms for buyer to raise a dispute after redeeming. Example: 604800000 = 7 days."
    },
    "resolutionPeriodDurationInMS": {
      "type": "number",
      "description": "Duration in ms to respond to a resolution proposal before it expires. Example: 259200000 = 3 days."
    },
    "voucherRedeemableFromDateInMS": {
      "type": "number",
      "description": "Timestamp in ms from which buyer can redeem. Must be >= validFromDateInMS."
    },
    "voucherRedeemableUntilDateInMS": {
      "type": "number",
      "description": "Timestamp in ms after which voucher cannot be redeemed. Set to 0 to use voucherValidDurationInMS instead."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "signature",
    "offerCreator",
    "committer",
    "sellerId",
    "buyerId",
    "metadataUri",
    "metadataHash",
    "price",
    "sellerDeposit",
    "buyerCancellationPenalty",
    "quantityAvailable",
    "validFromDateInMS",
    "validUntilDateInMS",
    "voucherRedeemableFromDateInMS",
    "voucherRedeemableUntilDateInMS",
    "disputePeriodDurationInMS",
    "voucherValidDurationInMS",
    "resolutionPeriodDurationInMS",
    "configId",
    "signerAddress"
  ],
  "properties": {
    "price": {
      "$ref": "#/properties/collectionIndex",
      "description": "Offer price in the exchange token's smallest unit (wei). Pass as string to avoid precision loss, e.g. '1000000000000000000' = 1 ETH."
    },
    "agentId": {
      "$ref": "#/properties/collectionIndex",
      "description": "Optional dACP agent facilitating this offer. Omit or pass '0' if no agent."
    },
    "buyerId": {
      "$ref": "#/properties/collectionIndex",
      "description": "Numeric ID of the buyer entity. Use '0' for seller-initiated offers."
    },
    "creator": {
      "enum": [
        "SELLER",
        "BUYER"
      ],
      "type": "string",
      "description": "'SELLER' (default) = seller creates offer. 'BUYER' = buyer-initiated offer, quantity must be 1."
    },
    "configId": {
      "type": "string",
      "description": "Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid values for this server."
    },
    "feeLimit": {
      "$ref": "#/properties/collectionIndex",
      "description": "Max protocol fee the seller accepts in same token unit. Pass as string."
    },
    "sellerId": {
      "$ref": "#/properties/collectionIndex",
      "description": "Numeric ID of the seller entity. Obtain via get_sellers_by_address."
    },
    "committer": {
      "$ref": "#/properties/offerCreator",
      "description": "Ethereum address of the buyer committing in the same transaction."
    },
    "condition": {
      "type": "object",
      "required": [
        "method",
        "tokenType",
        "tokenAddress",
        "gatingType",
        "minTokenId",
        "maxTokenId",
        "threshold",
        "maxCommits"
      ],
      "properties": {
        "method": {
          "type": "number",
          "description": "Gating method: 0=None, 1=Threshold (hold >= threshold tokens), 2=SpecificToken (hold specific token ID)."
        },
        "threshold": {
          "$ref": "#/properties/collectionIndex",
          "description": "Minimum token balance required. Pass as string."
        },
        "tokenType": {
          "type": "number",
          "description": "Token standard: 0=ERC-20, 1=ERC-721, 2=ERC-1155."
        },
        "gatingType": {
          "type": "number",
          "description": "0=PerAddress (each address commits once), 1=PerTokenId (each token ID can be used once)."
        },
        "maxCommits": {
          "$ref": "#/properties/collectionIndex",
          "description": "Max commits per qualifying address or token ID. Pass as string."
        },
        "maxTokenId": {
          "$ref": "#/properties/collectionIndex",
          "description": "Max token ID (inclusive) for ERC-721/1155 criteria. Pass as string."
        },
        "minTokenId": {
          "$ref": "#/properties/collectionIndex",
          "description": "Min token ID (inclusive) for ERC-721/1155 criteria. Pass as string."
        },
        "tokenAddress": {
          "$ref": "#/properties/offerCreator",
          "description": "Address of the gate token contract buyers must hold."
        }
      },
      "additionalProperties": false
    },
    "priceType": {
      "type": "number",
      "description": "0 = static price, 1 = discovery price (auction)."
    },
    "signature": {
      "type": "string",
      "description": "ECDSA signature over the offer typed data. Workflow: sign_full_offer → sign the returned typed data locally with your wallet (EIP-712) → use result here."
    },
    "metadataUri": {
      "type": "string",
      "description": "IPFS URI pointing to the offer metadata JSON. Obtain by calling store_product_v1_metadata, store_bundle_metadata, or store_base_metadata."
    },
    "royaltyInfo": {
      "type": "object",
      "required": [
        "recipients",
        "bps"
      ],
      "properties": {
        "bps": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "minItems": 0,
          "description": "Royalty amounts per recipient in basis points (1 bp = 0.01%). Parallel to recipients. Total must not exceed 10000."
        },
        "recipients": {
          "type": "array",
          "items": {
            "$ref": "#/properties/offerCreator",
            "description": "Valid Ethereum address (e.g. '0xAbCd...' or '0xabcd...'). Mixed-case addresses are checksum-validated; all-lowercase and all-uppercase addresses are also accepted."
          },
          "minItems": 0,
          "description": "Array of addresses receiving resale royalties."
        }
      },
      "additionalProperties": false
    },
    "metadataHash": {
      "type": "string",
      "description": "Keccak256 hash of the metadata JSON. Returned alongside metadataUri from the store_*_metadata tools."
    },
    "offerCreator": {
      "type": "string",
      "description": "Ethereum address of the seller creating this non-listed offer. Must match the seller's assistant address."
    },
    "executionMode": {
      "enum": [
        "direct",
        "metaTx"
      ],
      "type": "string",
      "description": "'direct' = standard on-chain tx (sign locally with your wallet → send_signed_transaction). 'metaTx' = gasless relay via Biconomy (send_meta_transaction). Defaults to 'direct'."
    },
    "sellerDeposit": {
      "$ref": "#/properties/collectionIndex",
      "description": "Seller collateral in same unit as price. Released to seller on completion or forfeited on dispute. Pass as string."
    },
    "signerAddress": {
      "$ref": "#/properties/offerCreator",
      "description": "Ethereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally."
    },
    "collectionIndex": {
      "type": "string",
      "description": "Index of the seller's NFT collection for vouchers. Omit to use default (index 0)."
    },
    "disputeResolverId": {
      "type": "string",
      "description": "ID of the dispute resolver for escalated disputes. Call get_dispute_resolvers to list available resolvers."
    },
    "quantityAvailable": {
      "type": "number",
      "description": "How many times this offer can be committed to. Must be 1 when creator='BUYER'.",
      "exclusiveMinimum": 0
    },
    "useDepositedFunds": {
      "type": "boolean",
      "description": "If true, use funds already deposited in the protocol treasury instead of transferring from the wallet."
    },
    "validFromDateInMS": {
      "type": "number",
      "description": "Unix timestamp in milliseconds when the offer becomes active. Example: Date.now() for immediate."
    },
    "conditionalTokenId": {
      "$ref": "#/properties/collectionIndex",
      "description": "Optional token ID of the NFT gate token used by this specific commit (for SpecificToken gating type)."
    },
    "validUntilDateInMS": {
      "type": "number",
      "description": "Unix timestamp in milliseconds when the offer can no longer be committed to."
    },
    "drMutualizerAddress": {
      "$ref": "#/properties/royaltyInfo/properties/recipients/items",
      "description": "Optional dispute resolver mutualizer contract address that pools resolution funds."
    },
    "exchangeTokenAddress": {
      "$ref": "#/properties/royaltyInfo/properties/recipients/items",
      "description": "ERC-20 token accepted for payment. Omit or use address(0) for native ETH. Call get_supported_tokens for valid values."
    },
    "buyerCancellationPenalty": {
      "$ref": "#/properties/collectionIndex",
      "description": "Amount buyer forfeits on cancel, in same unit as price. Must be <= price. Pass as string."
    },
    "voucherValidDurationInMS": {
      "type": "number",
      "description": "Voucher is redeemable for this many ms after commit. Set to 0 to use voucherRedeemableUntilDateInMS instead."
    },
    "disputePeriodDurationInMS": {
      "type": "number",
      "description": "Duration in ms for buyer to raise a dispute after redeeming. Example: 604800000 = 7 days."
    },
    "resolutionPeriodDurationInMS": {
      "type": "number",
      "description": "Duration in ms to respond to a resolution proposal before it expires. Example: 259200000 = 3 days."
    },
    "voucherRedeemableFromDateInMS": {
      "type": "number",
      "description": "Timestamp in ms from which buyer can redeem. Must be >= validFromDateInMS."
    },
    "voucherRedeemableUntilDateInMS": {
      "type": "number",
      "description": "Timestamp in ms after which voucher cannot be redeemed. Set to 0 to use voucherValidDurationInMS instead."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "condition",
    "metadataUri",
    "metadataHash",
    "price",
    "sellerDeposit",
    "buyerCancellationPenalty",
    "quantityAvailable",
    "validFromDateInMS",
    "validUntilDateInMS",
    "voucherRedeemableFromDateInMS",
    "voucherRedeemableUntilDateInMS",
    "disputePeriodDurationInMS",
    "voucherValidDurationInMS",
    "resolutionPeriodDurationInMS",
    "configId",
    "signerAddress"
  ],
  "properties": {
    "price": {
      "$ref": "#/properties/condition/properties/minTokenId",
      "description": "Offer price in the exchange token's smallest unit (wei). Pass as string to avoid precision loss, e.g. '1000000000000000000' = 1 ETH."
    },
    "agentId": {
      "$ref": "#/properties/condition/properties/minTokenId",
      "description": "Optional dACP agent facilitating this offer. Omit or pass '0' if no agent."
    },
    "creator": {
      "enum": [
        "SELLER",
        "BUYER"
      ],
      "type": "string",
      "description": "'SELLER' (default) = seller creates offer. 'BUYER' = buyer-initiated offer, quantity must be 1."
    },
    "configId": {
      "type": "string",
      "description": "Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid values for this server."
    },
    "feeLimit": {
      "$ref": "#/properties/agentId",
      "description": "Max protocol fee the seller accepts in same token unit. Pass as string."
    },
    "condition": {
      "type": "object",
      "required": [
        "method",
        "tokenType",
        "tokenAddress",
        "gatingType",
        "minTokenId",
        "maxTokenId",
        "threshold",
        "maxCommits"
      ],
      "properties": {
        "method": {
          "type": "number",
          "description": "Gating method: 0=None, 1=Threshold (hold >= threshold tokens), 2=SpecificToken (hold specific token ID)."
        },
        "threshold": {
          "$ref": "#/properties/condition/properties/minTokenId",
          "description": "Minimum token balance required. Pass as string."
        },
        "tokenType": {
          "type": "number",
          "description": "Token standard: 0=ERC-20, 1=ERC-721, 2=ERC-1155."
        },
        "gatingType": {
          "type": "number",
          "description": "0=PerAddress (each address commits once), 1=PerTokenId (each token ID can be used once)."
        },
        "maxCommits": {
          "$ref": "#/properties/condition/properties/minTokenId",
          "description": "Max commits per qualifying address or token ID. Pass as string."
        },
        "maxTokenId": {
          "$ref": "#/properties/condition/properties/minTokenId",
          "description": "Max token ID (inclusive) for ERC-721/1155 criteria. Pass as string."
        },
        "minTokenId": {
          "type": "string",
          "description": "Min token ID (inclusive) for ERC-721/1155 criteria. Pass as string."
        },
        "tokenAddress": {
          "type": "string",
          "description": "Address of the gate token contract buyers must hold."
        }
      },
      "additionalProperties": false
    },
    "priceType": {
      "type": "number",
      "description": "0 = static price, 1 = discovery price (auction)."
    },
    "metadataUri": {
      "type": "string",
      "description": "IPFS URI pointing to the offer metadata JSON. Obtain by calling store_product_v1_metadata, store_bundle_metadata, or store_base_metadata."
    },
    "royaltyInfo": {
      "type": "object",
      "required": [
        "recipients",
        "bps"
      ],
      "properties": {
        "bps": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "minItems": 0,
          "description": "Royalty amounts per recipient in basis points (1 bp = 0.01%). Parallel to recipients. Total must not exceed 10000."
        },
        "recipients": {
          "type": "array",
          "items": {
            "$ref": "#/properties/exchangeTokenAddress"
          },
          "minItems": 0,
          "description": "Array of addresses receiving resale royalties."
        }
      },
      "additionalProperties": false
    },
    "metadataHash": {
      "type": "string",
      "description": "Keccak256 hash of the metadata JSON. Returned alongside metadataUri from the store_*_metadata tools."
    },
    "executionMode": {
      "enum": [
        "direct",
        "metaTx"
      ],
      "type": "string",
      "description": "'direct' = standard on-chain tx (sign locally with your wallet → send_signed_transaction). 'metaTx' = gasless relay via Biconomy (send_meta_transaction). Defaults to 'direct'."
    },
    "sellerDeposit": {
      "$ref": "#/properties/condition/properties/minTokenId",
      "description": "Seller collateral in same unit as price. Released to seller on completion or forfeited on dispute. Pass as string."
    },
    "signerAddress": {
      "$ref": "#/properties/condition/properties/tokenAddress",
      "description": "Ethereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally."
    },
    "collectionIndex": {
      "$ref": "#/properties/agentId",
      "description": "Index of the seller's NFT collection for vouchers. Omit to use default (index 0)."
    },
    "disputeResolverId": {
      "type": "string",
      "description": "ID of the dispute resolver for escalated disputes. Call get_dispute_resolvers to list available resolvers."
    },
    "quantityAvailable": {
      "type": "number",
      "description": "How many times this offer can be committed to. Must be 1 when creator='BUYER'.",
      "exclusiveMinimum": 0
    },
    "validFromDateInMS": {
      "type": "number",
      "description": "Unix timestamp in milliseconds when the offer becomes active. Example: Date.now() for immediate."
    },
    "validUntilDateInMS": {
      "type": "number",
      "description": "Unix timestamp in milliseconds when the offer can no longer be committed to."
    },
    "drMutualizerAddress": {
      "$ref": "#/properties/exchangeTokenAddress",
      "description": "Optional dispute resolver mutualizer contract address that pools resolution funds."
    },
    "exchangeTokenAddress": {
      "$ref": "#/properties/condition/properties/tokenAddress",
      "description": "ERC-20 token accepted for payment. Omit or use address(0) for native ETH. Call get_supported_tokens for valid values."
    },
    "buyerCancellationPenalty": {
      "$ref": "#/properties/condition/properties/minTokenId",
      "description": "Amount buyer forfeits on cancel, in same unit as price. Must be <= price. Pass as string."
    },
    "voucherValidDurationInMS": {
      "type": "number",
      "description": "Voucher is redeemable for this many ms after commit. Set to 0 to use voucherRedeemableUntilDateInMS instead."
    },
    "disputePeriodDurationInMS": {
      "type": "number",
      "description": "Duration in ms for buyer to raise a dispute after redeeming. Example: 604800000 = 7 days."
    },
    "resolutionPeriodDurationInMS": {
      "type": "number",
      "description": "Duration in ms to respond to a resolution proposal before it expires. Example: 259200000 = 3 days."
    },
    "voucherRedeemableFromDateInMS": {
      "type": "number",
      "description": "Timestamp in ms from which buyer can redeem. Must be >= validFromDateInMS."
    },
    "voucherRedeemableUntilDateInMS": {
      "type": "number",
      "description": "Timestamp in ms after which voucher cannot be redeemed. Set to 0 to use voucherValidDurationInMS instead."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "type",
    "kind",
    "contactPreference",
    "royaltyPercentage",
    "authTokenId",
    "authTokenType",
    "configId",
    "signerAddress"
  ],
  "properties": {
    "kind": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "type": {
      "type": "string"
    },
    "images": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "url",
          "type"
        ],
        "properties": {
          "fit": {
            "type": "string"
          },
          "tag": {
            "type": "string"
          },
          "url": {
            "type": "string"
          },
          "type": {
            "type": "string"
          },
          "width": {
            "type": "number"
          },
          "height": {
            "type": "number"
          },
          "position": {
            "type": "string"
          }
        },
        "additionalProperties": true
      }
    },
    "website": {
      "type": "string"
    },
    "configId": {
      "type": "string",
      "description": "Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid values for this server."
    },
    "authTokenId": {
      "$ref": "#/properties/royaltyPercentage",
      "description": "NFT token ID used as auth token (e.g. Lens profile ID). Pass '0' if not using auth tokens."
    },
    "contractUri": {
      "type": "string",
      "default": "",
      "description": "Optional URI for OpenSea-style storefront metadata (defaults to empty string, meaning none). When set, it is fetched to copy it to The Graph's IPFS node, so it must be an ipfs:// URI, a CID, or an http(s) URL returning JSON."
    },
    "description": {
      "type": "string"
    },
    "socialLinks": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "url",
          "tag"
        ],
        "properties": {
          "tag": {
            "type": "string"
          },
          "url": {
            "type": "string"
          }
        },
        "additionalProperties": true
      }
    },
    "contactLinks": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "url",
          "tag"
        ],
        "properties": {
          "tag": {
            "type": "string"
          },
          "url": {
            "type": "string"
          }
        },
        "additionalProperties": true
      }
    },
    "authTokenType": {
      "type": "number",
      "description": "Auth token type: 0=None, 1=Lens Protocol profile NFT."
    },
    "executionMode": {
      "enum": [
        "direct",
        "metaTx"
      ],
      "type": "string",
      "description": "'direct' = standard on-chain tx (sign locally with your wallet → send_signed_transaction). 'metaTx' = gasless relay via Biconomy (send_meta_transaction). Defaults to 'direct'."
    },
    "salesChannels": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "tag"
        ],
        "properties": {
          "tag": {
            "type": "string"
          },
          "link": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "deployments": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "link": {
                  "type": "string"
                },
                "status": {
                  "type": "string"
                },
                "product": {
                  "type": "object",
                  "properties": {
                    "uuid": {
                      "type": "string"
                    },
                    "version": {
                      "type": "number"
                    }
                  },
                  "additionalProperties": false
                },
                "lastUpdated": {
                  "type": "string"
                }
              },
              "additionalProperties": false
            }
          },
          "settingsUrl": {
            "type": "string"
          },
          "settingsEditor": {
            "type": "string"
          }
        },
        "additionalProperties": true
      }
    },
    "signerAddress": {
      "type": "string",
      "description": "Ethereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally."
    },
    "legalTradingName": {
      "type": "string"
    },
    "contactPreference": {
      "type": "string"
    },
    "royaltyPercentage": {
      "type": "string",
      "description": "Default resale royalty in basis points (0–10000). Applied to all offers unless overridden."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "entityId",
    "tokenAddress",
    "amount",
    "configId",
    "signerAddress"
  ],
  "properties": {
    "amount": {
      "$ref": "#/properties/entityId",
      "description": "Amount in wei. For ERC-20, approve_exchange_token must be called first, unless relaying in metaTx mode with transferAuthorizations passed to send_meta_transaction. Pass as string."
    },
    "configId": {
      "type": "string",
      "description": "Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid values for this server."
    },
    "entityId": {
      "type": "string",
      "description": "Numeric ID of the entity to credit. Must match signerAddress's seller account."
    },
    "tokenAddress": {
      "type": "string",
      "description": "ERC-20 token to deposit. Use address(0) for native ETH."
    },
    "executionMode": {
      "enum": [
        "direct",
        "metaTx"
      ],
      "type": "string",
      "description": "'direct' = standard on-chain tx (sign locally with your wallet → send_signed_transaction). 'metaTx' = gasless relay via Biconomy (send_meta_transaction). Defaults to 'direct'."
    },
    "signerAddress": {
      "$ref": "#/properties/tokenAddress",
      "description": "Ethereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "configId"
  ],
  "properties": {
    "configId": {
      "type": "string",
      "description": "Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid values for this server."
    },
    "offersSkip": {
      "type": "number"
    },
    "offersFirst": {
      "type": "number"
    },
    "offersFilter": {
      "type": "object",
      "additionalProperties": {}
    },
    "exchangesSkip": {
      "type": "number"
    },
    "offersOrderBy": {
      "enum": [
        "agentFee",
        "agentId",
        "buyer",
        "buyerCancelPenalty",
        "buyerId",
        "buyer__active",
        "buyer__id",
        "buyer__wallet",
        "collection",
        "collectionIndex",
        "collection__collectionIndex",
        "collection__externalId",
        "collection__externalIdHash",
        "collection__id",
        "collection__sellerId",
        "condition",
        "condition__gatingType",
        "condition__id",
        "condition__maxCommits",
        "condition__maxTokenId",
        "condition__method",
        "condition__minTokenId",
        "condition__threshold",
        "condition__tokenAddress",
        "condition__tokenType",
        "createdAt",
        "creator",
        "disputePeriodDuration",
        "disputeResolutionTerms",
        "disputeResolutionTerms__buyerEscalationDeposit",
        "disputeResolutionTerms__disputeResolverId",
        "disputeResolutionTerms__escalationResponsePeriod",
        "disputeResolutionTerms__feeAmount",
        "disputeResolutionTerms__id",
        "disputeResolutionTerms__mutualizerAddress",
        "disputeResolver",
        "disputeResolverId",
        "disputeResolver__active",
        "disputeResolver__admin",
        "disputeResolver__assistant",
        "disputeResolver__clerk",
        "disputeResolver__escalationResponsePeriod",
        "disputeResolver__id",
        "disputeResolver__metadataUri",
        "disputeResolver__treasury",
        "exchangeToken",
        "exchangeToken__address",
        "exchangeToken__decimals",
        "exchangeToken__id",
        "exchangeToken__name",
        "exchangeToken__symbol",
        "exchanges",
        "id",
        "metadata",
        "metadataHash",
        "metadataUri",
        "metadata__animationUrl",
        "metadata__condition",
        "metadata__createdAt",
        "metadata__description",
        "metadata__externalUrl",
        "metadata__id",
        "metadata__image",
        "metadata__licenseUrl",
        "metadata__name",
        "metadata__numberOfCommits",
        "metadata__numberOfRedemptions",
        "metadata__quantityAvailable",
        "metadata__schemaUrl",
        "metadata__type",
        "metadata__validFromDate",
        "metadata__validUntilDate",
        "metadata__voided",
        "numberOfCommits",
        "numberOfRedemptions",
        "price",
        "priceType",
        "protocolFee",
        "quantityAvailable",
        "quantityInitial",
        "range",
        "range__end",
        "range__id",
        "range__minted",
        "range__owner",
        "range__start",
        "resolutionPeriodDuration",
        "royaltyInfos",
        "seller",
        "sellerDeposit",
        "sellerId",
        "seller__active",
        "seller__admin",
        "seller__assistant",
        "seller__authTokenId",
        "seller__authTokenType",
        "seller__clerk",
        "seller__id",
        "seller__metadataUri",
        "seller__sellerId",
        "seller__treasury",
        "seller__voucherCloneAddress",
        "validFromDate",
        "validUntilDate",
        "voided",
        "voidedAt",
        "voucherRedeemableFromDate",
        "voucherRedeemableUntilDate",
        "voucherValidDuration"
      ],
      "type": "string"
    },
    "exchangesFirst": {
      "type": "number"
    },
    "exchangesFilter": {
      "type": "object",
      "additionalProperties": {}
    },
    "exchangesOrderBy": {
      "enum": [
        "buyer",
        "buyer__active",
        "buyer__id",
        "buyer__wallet",
        "cancelledDate",
        "committedDate",
        "completedDate",
        "dispute",
        "disputeResolver",
        "disputeResolver__active",
        "disputeResolver__admin",
        "disputeResolver__assistant",
        "disputeResolver__clerk",
        "disputeResolver__escalationResponsePeriod",
        "disputeResolver__id",
        "disputeResolver__metadataUri",
        "disputeResolver__treasury",
        "dispute__buyerPercent",
        "dispute__decidedDate",
        "dispute__disputedDate",
        "dispute__escalatedDate",
        "dispute__exchangeId",
        "dispute__finalizedDate",
        "dispute__id",
        "dispute__refusedDate",
        "dispute__resolvedDate",
        "dispute__retractedDate",
        "dispute__state",
        "dispute__timeout",
        "disputed",
        "disputedDate",
        "expired",
        "finalizedDate",
        "id",
        "mutualizerAddress",
        "offer",
        "offer__agentFee",
        "offer__agentId",
        "offer__buyerCancelPenalty",
        "offer__buyerId",
        "offer__collectionIndex",
        "offer__createdAt",
        "offer__creator",
        "offer__disputePeriodDuration",
        "offer__disputeResolverId",
        "offer__id",
        "offer__metadataHash",
        "offer__metadataUri",
        "offer__numberOfCommits",
        "offer__numberOfRedemptions",
        "offer__price",
        "offer__priceType",
        "offer__protocolFee",
        "offer__quantityAvailable",
        "offer__quantityInitial",
        "offer__resolutionPeriodDuration",
        "offer__sellerDeposit",
        "offer__sellerId",
        "offer__validFromDate",
        "offer__validUntilDate",
        "offer__voided",
        "offer__voidedAt",
        "offer__voucherRedeemableFromDate",
        "offer__voucherRedeemableUntilDate",
        "offer__voucherValidDuration",
        "protocolFeeCollected",
        "protocolFeeCollected__amount",
        "protocolFeeCollected__exchangeId",
        "protocolFeeCollected__exchangeToken",
        "protocolFeeCollected__executedBy",
        "protocolFeeCollected__id",
        "redeemedDate",
        "revokedDate",
        "seller",
        "seller__active",
        "seller__admin",
        "seller__assistant",
        "seller__authTokenId",
        "seller__authTokenType",
        "seller__clerk",
        "seller__id",
        "seller__metadataUri",
        "seller__sellerId",
        "seller__treasury",
        "seller__voucherCloneAddress",
        "state",
        "validUntilDate"
      ],
      "type": "string"
    },
    "includeExchanges": {
      "type": "boolean"
    },
    "offersOrderDirection": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string"
    },
    "exchangesOrderDirection": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "configId"
  ],
  "properties": {
    "configId": {
      "type": "string",
      "description": "Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid values for this server."
    },
    "includeLogs": {
      "type": "boolean"
    },
    "sellersSkip": {
      "type": "number"
    },
    "includeFunds": {
      "type": "boolean"
    },
    "sellersFirst": {
      "type": "number"
    },
    "includeOffers": {
      "type": "boolean"
    },
    "sellersFilter": {
      "type": "object",
      "additionalProperties": {}
    },
    "sellersOrderBy": {
      "enum": [
        "active",
        "admin",
        "assistant",
        "authTokenId",
        "authTokenType",
        "clerk",
        "collections",
        "exchanges",
        "funds",
        "id",
        "logs",
        "metadata",
        "metadataUri",
        "metadata__contactPreference",
        "metadata__createdAt",
        "metadata__description",
        "metadata__id",
        "metadata__kind",
        "metadata__legalTradingName",
        "metadata__name",
        "metadata__type",
        "metadata__website",
        "offers",
        "pendingSeller",
        "pendingSeller__admin",
        "pendingSeller__assistant",
        "pendingSeller__authTokenId",
        "pendingSeller__authTokenType",
        "pendingSeller__clerk",
        "pendingSeller__id",
        "pendingSeller__metadataUri",
        "royaltyRecipients",
        "sellerId",
        "treasury",
        "voucherCloneAddress"
      ],
      "type": "string"
    },
    "includeExchanges": {
      "type": "boolean"
    },
    "sellersOrderDirection": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "address",
    "configId"
  ],
  "properties": {
    "address": {
      "type": "string"
    },
    "configId": {
      "type": "string",
      "description": "Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid values for this server."
    },
    "includeLogs": {
      "type": "boolean"
    },
    "sellersSkip": {
      "type": "number"
    },
    "includeFunds": {
      "type": "boolean"
    },
    "sellersFirst": {
      "type": "number"
    },
    "includeOffers": {
      "type": "boolean"
    },
    "sellersFilter": {
      "type": "object",
      "additionalProperties": {}
    },
    "sellersOrderBy": {
      "enum": [
        "active",
        "admin",
        "assistant",
        "authTokenId",
        "authTokenType",
        "clerk",
        "collections",
        "exchanges",
        "funds",
        "id",
        "logs",
        "metadata",
        "metadataUri",
        "metadata__contactPreference",
        "metadata__createdAt",
        "metadata__description",
        "metadata__id",
        "metadata__kind",
        "metadata__legalTradingName",
        "metadata__name",
        "metadata__type",
        "metadata__website",
        "offers",
        "pendingSeller",
        "pendingSeller__admin",
        "pendingSeller__assistant",
        "pendingSeller__authTokenId",
        "pendingSeller__authTokenType",
        "pendingSeller__clerk",
        "pendingSeller__id",
        "pendingSeller__metadataUri",
        "royaltyRecipients",
        "sellerId",
        "treasury",
        "voucherCloneAddress"
      ],
      "type": "string"
    },
    "includeExchanges": {
      "type": "boolean"
    },
    "sellersOrderDirection": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "exchangeId",
    "buyerPercentBasisPoints",
    "sigR",
    "sigS",
    "sigV",
    "configId",
    "signerAddress"
  ],
  "properties": {
    "sigR": {
      "type": "string",
      "description": "32-byte R component of the ECDSA resolution signature as 0x-prefixed hex. From the locally-signed EIP-712 signature parameters."
    },
    "sigS": {
      "type": "string",
      "description": "32-byte S component as 0x-prefixed hex. From the locally-signed EIP-712 signature parameters."
    },
    "sigV": {
      "$ref": "#/properties/exchangeId",
      "description": "Recovery byte V: 27 or 28. From the locally-signed EIP-712 signature parameters."
    },
    "configId": {
      "type": "string",
      "description": "Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid values for this server."
    },
    "exchangeId": {
      "type": "string",
      "description": "Numeric ID of the exchange/dispute to act on. Obtain from get_exchanges or the response of commit_to_offer."
    },
    "executionMode": {
      "enum": [
        "direct",
        "metaTx"
      ],
      "type": "string",
      "description": "'direct' = standard on-chain tx (sign locally with your wallet → send_signed_transaction). 'metaTx' = gasless relay via Biconomy (send_meta_transaction). Defaults to 'direct'."
    },
    "signerAddress": {
      "type": "string",
      "description": "Ethereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally."
    },
    "buyerPercentBasisPoints": {
      "$ref": "#/properties/exchangeId",
      "description": "Agreed buyer share in basis points (0–10000). Both parties must sign the same value. Obtain via create_dispute_resolution_proposal then sign the typed data locally with each party's wallet (EIP-712)."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "keywords",
    "configId"
  ],
  "properties": {
    "configId": {
      "type": "string",
      "description": "Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid values for this server."
    },
    "keywords": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      },
      "minItems": 1,
      "description": "List of keywords matched against product title, description, brand, category, and tags."
    },
    "productsSkip": {
      "type": "number"
    },
    "productsFirst": {
      "type": "number"
    },
    "productsFilter": {
      "type": "object",
      "additionalProperties": {}
    },
    "productsOrderBy": {
      "enum": [
        "allVariantsVoided",
        "brand",
        "brand__id",
        "brand__name",
        "category",
        "category__id",
        "category__name",
        "description",
        "details_category",
        "details_offerCategory",
        "details_personalisation",
        "details_sections",
        "details_subCategory",
        "details_subCategory2",
        "details_tags",
        "disputeResolverId",
        "id",
        "identification_productId",
        "identification_productIdType",
        "identification_sKU",
        "maxValidFromDate",
        "maxValidUntilDate",
        "minValidFromDate",
        "minValidUntilDate",
        "notVoidedVariants",
        "offerCategory",
        "packaging_dimensions_height",
        "packaging_dimensions_length",
        "packaging_dimensions_unit",
        "packaging_dimensions_width",
        "packaging_packageQuantity",
        "packaging_weight_unit",
        "packaging_weight_value",
        "personalisation",
        "productV1Seller",
        "productV1Seller__contactPreference",
        "productV1Seller__defaultVersion",
        "productV1Seller__description",
        "productV1Seller__externalUrl",
        "productV1Seller__id",
        "productV1Seller__name",
        "productV1Seller__sellerId",
        "productV1Seller__tokenId",
        "productionInformation_brandName",
        "productionInformation_manufacturer",
        "productionInformation_manufacturerPartNumber",
        "productionInformation_materials",
        "productionInformation_modelNumber",
        "salesChannels",
        "sections",
        "sellerId",
        "subCategory",
        "subCategory2",
        "subCategory2__id",
        "subCategory2__name",
        "subCategory__id",
        "subCategory__name",
        "tags",
        "title",
        "uuid",
        "variants",
        "version",
        "visuals_images",
        "visuals_videos"
      ],
      "type": "string"
    },
    "includeInvalidOffers": {
      "type": "boolean",
      "description": "When true, include products whose offers are outside their validity window. Defaults to false (valid offers only)."
    },
    "productsOrderDirection": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "functionName",
    "functionSignature",
    "nonce",
    "sigR",
    "sigS",
    "sigV",
    "configId",
    "signerAddress"
  ],
  "properties": {
    "sigR": {
      "type": "string",
      "pattern": "^0x[a-fA-F0-9]{64}$"
    },
    "sigS": {
      "type": "string",
      "pattern": "^0x[a-fA-F0-9]{64}$"
    },
    "sigV": {
      "type": [
        "string",
        "number"
      ]
    },
    "nonce": {
      "type": [
        "string",
        "number"
      ]
    },
    "configId": {
      "type": "string",
      "description": "Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid values for this server."
    },
    "functionName": {
      "type": "string",
      "minLength": 1
    },
    "signerAddress": {
      "type": "string",
      "description": "Ethereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally."
    },
    "functionSignature": {
      "type": "string",
      "pattern": "^0x[a-fA-F0-9]+$"
    },
    "transferAuthorizations": {
      "type": "array",
      "items": {
        "anyOf": [
          {
            "type": "object",
            "required": [
              "strategy",
              "data",
              "signature"
            ],
            "properties": {
              "r": {
                "$ref": "#/properties/transferAuthorizations/items/anyOf/0/properties/data/properties/nonce",
                "description": "Optional r component. Derived from `signature` if omitted."
              },
              "s": {
                "$ref": "#/properties/transferAuthorizations/items/anyOf/0/properties/data/properties/nonce",
                "description": "Optional s component. Derived from `signature` if omitted."
              },
              "v": {
                "anyOf": [
                  {
                    "type": "string",
                    "pattern": "^\\d+$"
                  },
                  {
                    "type": "integer"
                  }
                ],
                "description": "Optional v component (27/28, or 0/1). Derived from `signature` if omitted. Provide r, s and v together or not at all."
              },
              "data": {
                "type": "object",
                "required": [
                  "validAfter",
                  "validBefore",
                  "nonce"
                ],
                "properties": {
                  "nonce": {
                    "type": "string",
                    "pattern": "^0x[a-fA-F0-9]{64}$"
                  },
                  "validAfter": {
                    "anyOf": [
                      {
                        "type": "string",
                        "pattern": "^(\\d+|0x[a-fA-F0-9]+)$"
                      },
                      {
                        "type": "integer",
                        "maximum": 9007199254740991,
                        "minimum": 0
                      }
                    ]
                  },
                  "validBefore": {
                    "$ref": "#/properties/transferAuthorizations/items/anyOf/0/properties/data/properties/validAfter"
                  }
                },
                "additionalProperties": false
              },
              "strategy": {
                "type": "string",
                "const": "ERC3009"
              },
              "signature": {
                "type": "string",
                "pattern": "^0x[a-fA-F0-9]+$",
                "description": "Signature of the typed data returned by the matching sign_receive_with_* tool, signed locally with your wallet (EIP-712)."
              }
            },
            "additionalProperties": false
          },
          {
            "type": "object",
            "required": [
              "strategy",
              "data",
              "signature"
            ],
            "properties": {
              "r": {
                "$ref": "#/properties/transferAuthorizations/items/anyOf/0/properties/r"
              },
              "s": {
                "$ref": "#/properties/transferAuthorizations/items/anyOf/0/properties/s"
              },
              "v": {
                "$ref": "#/properties/transferAuthorizations/items/anyOf/0/properties/v"
              },
              "data": {
                "type": "object",
                "required": [
                  "deadline"
                ],
                "properties": {
                  "deadline": {
                    "$ref": "#/properties/transferAuthorizations/items/anyOf/0/properties/data/properties/validAfter"
                  }
                },
                "additionalProperties": false
              },
              "strategy": {
                "type": "string",
                "const": "EIP2612"
              },
              "signature": {
                "$ref": "#/properties/transferAuthorizations/items/anyOf/0/properties/signature"
              }
            },
            "additionalProperties": false
          },
          {
            "type": "object",
            "required": [
              "strategy",
              "data",
              "signature"
            ],
            "properties": {
              "r": {
                "$ref": "#/properties/transferAuthorizations/items/anyOf/0/properties/r"
              },
              "s": {
                "$ref": "#/properties/transferAuthorizations/items/anyOf/0/properties/s"
              },
              "v": {
                "$ref": "#/properties/transferAuthorizations/items/anyOf/0/properties/v"
              },
              "data": {
                "type": "object",
                "required": [
                  "nonce",
                  "deadline"
                ],
                "properties": {
                  "nonce": {
                    "$ref": "#/properties/transferAuthorizations/items/anyOf/0/properties/data/properties/validAfter"
                  },
                  "deadline": {
                    "$ref": "#/properties/transferAuthorizations/items/anyOf/0/properties/data/properties/validAfter"
                  }
                },
                "additionalProperties": false
              },
              "strategy": {
                "type": "string",
                "const": "Permit2"
              },
              "signature": {
                "$ref": "#/properties/transferAuthorizations/items/anyOf/0/properties/signature"
              }
            },
            "additionalProperties": false
          },
          {
            "type": "object",
            "required": [
              "strategy",
              "data",
              "signature"
            ],
            "properties": {
              "r": {
                "$ref": "#/properties/transferAuthorizations/items/anyOf/0/properties/r"
              },
              "s": {
                "$ref": "#/properties/transferAuthorizations/items/anyOf/0/properties/s"
              },
              "v": {
                "$ref": "#/properties/transferAuthorizations/items/anyOf/0/properties/v"
              },
              "data": {
                "type": "object",
                "required": [
                  "nonce",
                  "expiry"
                ],
                "properties": {
                  "nonce": {
                    "$ref": "#/properties/transferAuthorizations/items/anyOf/0/properties/data/properties/validAfter"
                  },
                  "expiry": {
                    "$ref": "#/properties/transferAuthorizations/items/anyOf/0/properties/data/properties/validAfter"
                  }
                },
                "additionalProperties": false
              },
              "strategy": {
                "type": "string",
                "const": "DAIPermit"
              },
              "signature": {
                "$ref": "#/properties/transferAuthorizations/items/anyOf/0/properties/signature"
              }
            },
            "additionalProperties": false
          }
        ]
      },
      "description": "Optional ERC-20 transfer authorizations that let the protocol pull tokens without a prior approve_exchange_token tx (e.g. commit_to_offer or deposit_funds in metaTx mode). Build each entry with the matching sign_receive_with_* tool: sign its `typedData` locally and add the resulting `signature` to its `transferAuthorization` object."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "contractAddress",
    "functionSignature",
    "sigR",
    "sigS",
    "sigV",
    "configId",
    "signerAddress"
  ],
  "properties": {
    "sigR": {
      "type": "string",
      "pattern": "^0x[a-fA-F0-9]{64}$"
    },
    "sigS": {
      "type": "string",
      "pattern": "^0x[a-fA-F0-9]{64}$"
    },
    "sigV": {
      "type": [
        "string",
        "number"
      ]
    },
    "configId": {
      "type": "string",
      "description": "Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid values for this server."
    },
    "signerAddress": {
      "$ref": "#/properties/contractAddress",
      "description": "Ethereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally."
    },
    "contractAddress": {
      "type": "string",
      "description": "Valid Ethereum address (e.g. '0xAbCd...' or '0xabcd...'). Mixed-case addresses are checksum-validated; all-lowercase and all-uppercase addresses are also accepted."
    },
    "functionSignature": {
      "type": "string",
      "pattern": "^0x[a-fA-F0-9]+$"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "offerCreator",
    "committer",
    "sellerId",
    "buyerId",
    "metadataUri",
    "metadataHash",
    "price",
    "sellerDeposit",
    "buyerCancellationPenalty",
    "quantityAvailable",
    "validFromDateInMS",
    "validUntilDateInMS",
    "voucherRedeemableFromDateInMS",
    "voucherRedeemableUntilDateInMS",
    "disputePeriodDurationInMS",
    "voucherValidDurationInMS",
    "resolutionPeriodDurationInMS",
    "configId",
    "signerAddress"
  ],
  "properties": {
    "price": {
      "$ref": "#/properties/collectionIndex",
      "description": "Offer price in the exchange token's smallest unit (wei). Pass as string to avoid precision loss, e.g. '1000000000000000000' = 1 ETH."
    },
    "agentId": {
      "$ref": "#/properties/collectionIndex",
      "description": "Optional dACP agent facilitating this offer. Omit or pass '0' if no agent."
    },
    "buyerId": {
      "$ref": "#/properties/collectionIndex",
      "description": "Numeric ID of the buyer entity. Use '0' for seller-initiated offers."
    },
    "creator": {
      "enum": [
        "SELLER",
        "BUYER"
      ],
      "type": "string",
      "description": "'SELLER' (default) = seller creates offer. 'BUYER' = buyer-initiated offer, quantity must be 1."
    },
    "configId": {
      "type": "string",
      "description": "Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid values for this server."
    },
    "feeLimit": {
      "$ref": "#/properties/collectionIndex",
      "description": "Max protocol fee the seller accepts in same token unit. Pass as string."
    },
    "sellerId": {
      "$ref": "#/properties/collectionIndex",
      "description": "Numeric ID of the seller entity. Obtain via get_sellers_by_address."
    },
    "committer": {
      "$ref": "#/properties/offerCreator",
      "description": "Ethereum address of the buyer committing in the same transaction."
    },
    "condition": {
      "type": "object",
      "required": [
        "method",
        "tokenType",
        "tokenAddress",
        "gatingType",
        "minTokenId",
        "maxTokenId",
        "threshold",
        "maxCommits"
      ],
      "properties": {
        "method": {
          "type": "number",
          "description": "Gating method: 0=None, 1=Threshold (hold >= threshold tokens), 2=SpecificToken (hold specific token ID)."
        },
        "threshold": {
          "$ref": "#/properties/collectionIndex",
          "description": "Minimum token balance required. Pass as string."
        },
        "tokenType": {
          "type": "number",
          "description": "Token standard: 0=ERC-20, 1=ERC-721, 2=ERC-1155."
        },
        "gatingType": {
          "type": "number",
          "description": "0=PerAddress (each address commits once), 1=PerTokenId (each token ID can be used once)."
        },
        "maxCommits": {
          "$ref": "#/properties/collectionIndex",
          "description": "Max commits per qualifying address or token ID. Pass as string."
        },
        "maxTokenId": {
          "$ref": "#/properties/collectionIndex",
          "description": "Max token ID (inclusive) for ERC-721/1155 criteria. Pass as string."
        },
        "minTokenId": {
          "$ref": "#/properties/collectionIndex",
          "description": "Min token ID (inclusive) for ERC-721/1155 criteria. Pass as string."
        },
        "tokenAddress": {
          "$ref": "#/properties/offerCreator",
          "description": "Address of the gate token contract buyers must hold."
        }
      },
      "additionalProperties": false
    },
    "priceType": {
      "type": "number",
      "description": "0 = static price, 1 = discovery price (auction)."
    },
    "metadataUri": {
      "type": "string",
      "description": "IPFS URI pointing to the offer metadata JSON. Obtain by calling store_product_v1_metadata, store_bundle_metadata, or store_base_metadata."
    },
    "royaltyInfo": {
      "type": "object",
      "required": [
        "recipients",
        "bps"
      ],
      "properties": {
        "bps": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "minItems": 0,
          "description": "Royalty amounts per recipient in basis points (1 bp = 0.01%). Parallel to recipients. Total must not exceed 10000."
        },
        "recipients": {
          "type": "array",
          "items": {
            "$ref": "#/properties/offerCreator",
            "description": "Valid Ethereum address (e.g. '0xAbCd...' or '0xabcd...'). Mixed-case addresses are checksum-validated; all-lowercase and all-uppercase addresses are also accepted."
          },
          "minItems": 0,
          "description": "Array of addresses receiving resale royalties."
        }
      },
      "additionalProperties": false
    },
    "metadataHash": {
      "type": "string",
      "description": "Keccak256 hash of the metadata JSON. Returned alongside metadataUri from the store_*_metadata tools."
    },
    "offerCreator": {
      "type": "string",
      "description": "Ethereum address of the seller creating this non-listed offer. Must match the seller's assistant address."
    },
    "executionMode": {
      "enum": [
        "direct",
        "metaTx"
      ],
      "type": "string",
      "description": "'direct' = standard on-chain tx (sign locally with your wallet → send_signed_transaction). 'metaTx' = gasless relay via Biconomy (send_meta_transaction). Defaults to 'direct'."
    },
    "sellerDeposit": {
      "$ref": "#/properties/collectionIndex",
      "description": "Seller collateral in same unit as price. Released to seller on completion or forfeited on dispute. Pass as string."
    },
    "signerAddress": {
      "$ref": "#/properties/offerCreator",
      "description": "Ethereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally."
    },
    "collectionIndex": {
      "type": "string",
      "description": "Index of the seller's NFT collection for vouchers. Omit to use default (index 0)."
    },
    "disputeResolverId": {
      "type": "string",
      "description": "ID of the dispute resolver for escalated disputes. Call get_dispute_resolvers to list available resolvers."
    },
    "quantityAvailable": {
      "type": "number",
      "description": "How many times this offer can be committed to. Must be 1 when creator='BUYER'.",
      "exclusiveMinimum": 0
    },
    "useDepositedFunds": {
      "type": "boolean",
      "description": "If true, use funds already deposited in the protocol treasury instead of transferring from the wallet."
    },
    "validFromDateInMS": {
      "type": "number",
      "description": "Unix timestamp in milliseconds when the offer becomes active. Example: Date.now() for immediate."
    },
    "conditionalTokenId": {
      "$ref": "#/properties/collectionIndex",
      "description": "Optional token ID of the NFT gate token used by this specific commit (for SpecificToken gating type)."
    },
    "validUntilDateInMS": {
      "type": "number",
      "description": "Unix timestamp in milliseconds when the offer can no longer be committed to."
    },
    "drMutualizerAddress": {
      "$ref": "#/properties/royaltyInfo/properties/recipients/items",
      "description": "Optional dispute resolver mutualizer contract address that pools resolution funds."
    },
    "exchangeTokenAddress": {
      "$ref": "#/properties/royaltyInfo/properties/recipients/items",
      "description": "ERC-20 token accepted for payment. Omit or use address(0) for native ETH. Call get_supported_tokens for valid values."
    },
    "buyerCancellationPenalty": {
      "$ref": "#/properties/collectionIndex",
      "description": "Amount buyer forfeits on cancel, in same unit as price. Must be <= price. Pass as string."
    },
    "voucherValidDurationInMS": {
      "type": "number",
      "description": "Voucher is redeemable for this many ms after commit. Set to 0 to use voucherRedeemableUntilDateInMS instead."
    },
    "disputePeriodDurationInMS": {
      "type": "number",
      "description": "Duration in ms for buyer to raise a dispute after redeeming. Example: 604800000 = 7 days."
    },
    "resolutionPeriodDurationInMS": {
      "type": "number",
      "description": "Duration in ms to respond to a resolution proposal before it expires. Example: 259200000 = 3 days."
    },
    "voucherRedeemableFromDateInMS": {
      "type": "number",
      "description": "Timestamp in ms from which buyer can redeem. Must be >= validFromDateInMS."
    },
    "voucherRedeemableUntilDateInMS": {
      "type": "number",
      "description": "Timestamp in ms after which voucher cannot be redeemed. Set to 0 to use voucherValidDurationInMS instead."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "exchangeTokenAddress",
    "value",
    "tokenDomainName",
    "expiry",
    "configId",
    "signerAddress"
  ],
  "properties": {
    "value": {
      "type": "string",
      "description": "Amount in wei the spender is authorized to pull from the signer."
    },
    "expiry": {
      "$ref": "#/properties/value",
      "description": "Unix timestamp in seconds after which the DAI-style permit is no longer valid."
    },
    "spender": {
      "$ref": "#/properties/exchangeTokenAddress",
      "description": "Optional spender address. Defaults to the Boson Protocol diamond from SDK config."
    },
    "configId": {
      "type": "string",
      "description": "Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid values for this server."
    },
    "signerAddress": {
      "$ref": "#/properties/exchangeTokenAddress",
      "description": "Ethereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally."
    },
    "tokenDomainName": {
      "type": "string",
      "minLength": 1,
      "description": "EIP-712 domain name of the DAI-style token (e.g. 'Dai Stablecoin')."
    },
    "exchangeTokenAddress": {
      "type": "string",
      "description": "ERC-20 token contract address that supports the permit/authorization standard."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "exchangeTokenAddress",
    "value",
    "tokenDomainName",
    "tokenDomainVersion",
    "deadline",
    "configId",
    "signerAddress"
  ],
  "properties": {
    "value": {
      "type": "string",
      "description": "Amount in wei the spender is authorized to pull from the signer."
    },
    "spender": {
      "$ref": "#/properties/exchangeTokenAddress",
      "description": "Optional spender address. Defaults to the Boson Protocol diamond from SDK config."
    },
    "configId": {
      "type": "string",
      "description": "Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid values for this server."
    },
    "deadline": {
      "$ref": "#/properties/value",
      "description": "Unix timestamp in seconds after which the permit is no longer valid."
    },
    "signerAddress": {
      "$ref": "#/properties/exchangeTokenAddress",
      "description": "Ethereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally."
    },
    "tokenDomainName": {
      "type": "string",
      "minLength": 1,
      "description": "EIP-712 domain name of the token contract (e.g. 'USD Coin'). Required for ERC-3009 / EIP-2612 domain separator."
    },
    "tokenDomainVersion": {
      "type": "string",
      "minLength": 1,
      "description": "EIP-712 domain version of the token contract (e.g. '2'). Required for ERC-3009 / EIP-2612 domain separator."
    },
    "exchangeTokenAddress": {
      "type": "string",
      "description": "ERC-20 token contract address that supports the permit/authorization standard."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "exchangeTokenAddress",
    "value",
    "tokenDomainName",
    "tokenDomainVersion",
    "validAfter",
    "validBefore",
    "configId",
    "signerAddress"
  ],
  "properties": {
    "value": {
      "type": "string",
      "description": "Amount in wei the spender is authorized to pull from the signer."
    },
    "spender": {
      "$ref": "#/properties/exchangeTokenAddress",
      "description": "Optional spender address. Defaults to the Boson Protocol diamond from SDK config."
    },
    "configId": {
      "type": "string",
      "description": "Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid values for this server."
    },
    "validAfter": {
      "$ref": "#/properties/value",
      "description": "Unix timestamp in seconds before which the authorization is not valid."
    },
    "validBefore": {
      "$ref": "#/properties/value",
      "description": "Unix timestamp in seconds after which the authorization is no longer valid."
    },
    "signerAddress": {
      "$ref": "#/properties/exchangeTokenAddress",
      "description": "Ethereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally."
    },
    "tokenDomainName": {
      "type": "string",
      "minLength": 1,
      "description": "EIP-712 domain name of the token contract (e.g. 'USD Coin'). Required for ERC-3009 / EIP-2612 domain separator."
    },
    "tokenDomainVersion": {
      "type": "string",
      "minLength": 1,
      "description": "EIP-712 domain version of the token contract (e.g. '2'). Required for ERC-3009 / EIP-2612 domain separator."
    },
    "exchangeTokenAddress": {
      "type": "string",
      "description": "ERC-20 token contract address that supports the permit/authorization standard."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "exchangeTokenAddress",
    "value",
    "deadline",
    "configId",
    "signerAddress"
  ],
  "properties": {
    "value": {
      "type": "string",
      "description": "Amount in wei the spender is authorized to pull from the signer."
    },
    "spender": {
      "$ref": "#/properties/exchangeTokenAddress",
      "description": "Optional spender address. Defaults to the Boson Protocol diamond from SDK config."
    },
    "configId": {
      "type": "string",
      "description": "Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid values for this server."
    },
    "deadline": {
      "$ref": "#/properties/value",
      "description": "Unix timestamp in seconds after which the Permit2 authorization is no longer valid."
    },
    "permit2Nonce": {
      "$ref": "#/properties/value",
      "description": "Optional Permit2 nonce as a uint256 string. If omitted, a random uint256 is generated."
    },
    "signerAddress": {
      "$ref": "#/properties/exchangeTokenAddress",
      "description": "Ethereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally."
    },
    "permit2Address": {
      "$ref": "#/properties/spender",
      "description": "Optional Uniswap Permit2 contract address. Defaults to contracts.permit2 from SDK config."
    },
    "exchangeTokenAddress": {
      "type": "string",
      "description": "ERC-20 token contract address that supports the permit/authorization standard."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "schemaUrl",
    "type",
    "name",
    "description",
    "externalUrl",
    "licenseUrl",
    "configId",
    "signerAddress"
  ],
  "properties": {
    "name": {
      "type": "string"
    },
    "type": {
      "enum": [
        "BASE"
      ],
      "type": "string"
    },
    "image": {
      "type": "string"
    },
    "configId": {
      "type": "string",
      "description": "Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid values for this server."
    },
    "condition": {
      "type": "string"
    },
    "imageData": {
      "type": "string"
    },
    "schemaUrl": {
      "type": "string"
    },
    "attributes": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "traitType",
          "value"
        ],
        "properties": {
          "value": {
            "type": "string"
          },
          "traitType": {
            "type": "string"
          },
          "displayType": {
            "type": "string"
          }
        },
        "additionalProperties": true
      }
    },
    "licenseUrl": {
      "type": "string"
    },
    "youtubeUrl": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "externalUrl": {
      "type": "string"
    },
    "animationUrl": {
      "type": "string"
    },
    "signerAddress": {
      "type": "string",
      "description": "Ethereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "schemaUrl",
    "type",
    "name",
    "configId",
    "signerAddress"
  ],
  "properties": {
    "name": {
      "type": "string"
    },
    "type": {
      "enum": [
        "ITEM_NFT"
      ],
      "type": "string"
    },
    "image": {
      "type": "string"
    },
    "terms": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "key",
          "value"
        ],
        "properties": {
          "key": {
            "type": "string"
          },
          "value": {
            "type": "string"
          },
          "displayKey": {
            "type": "string"
          }
        },
        "additionalProperties": true
      }
    },
    "chainId": {
      "type": "number"
    },
    "tokenId": {
      "type": "string"
    },
    "configId": {
      "type": "string",
      "description": "Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid values for this server."
    },
    "contract": {
      "type": "string"
    },
    "quantity": {
      "type": "number"
    },
    "imageData": {
      "type": "string"
    },
    "schemaUrl": {
      "type": "string"
    },
    "attributes": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "value"
        ],
        "properties": {
          "value": {
            "type": "string"
          },
          "traitType": {
            "type": "string"
          },
          "trait_type": {
            "type": "string"
          },
          "displayType": {
            "type": "string"
          },
          "display_type": {
            "type": "string"
          }
        },
        "additionalProperties": true
      }
    },
    "image_data": {
      "type": "string"
    },
    "youtubeUrl": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "externalUrl": {
      "type": "string"
    },
    "youtube_url": {
      "type": "string"
    },
    "animationUrl": {
      "type": "string"
    },
    "external_url": {
      "type": "string"
    },
    "tokenIdRange": {
      "type": "object",
      "properties": {
        "max": {
          "type": "string"
        },
        "min": {
          "type": "string"
        }
      },
      "additionalProperties": true
    },
    "animation_url": {
      "type": "string"
    },
    "signerAddress": {
      "type": "string",
      "description": "Ethereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "schemaUrl",
    "type",
    "uuid",
    "product",
    "shipping",
    "exchangePolicy",
    "configId",
    "signerAddress"
  ],
  "properties": {
    "type": {
      "enum": [
        "ITEM_PRODUCT_V1"
      ],
      "type": "string"
    },
    "uuid": {
      "type": "string"
    },
    "product": {
      "type": "object",
      "required": [
        "uuid",
        "version",
        "title",
        "description",
        "productionInformation_brandName",
        "details_offerCategory",
        "visuals_images"
      ],
      "properties": {
        "uuid": {
          "type": "string"
        },
        "title": {
          "type": "string"
        },
        "version": {
          "type": "number"
        },
        "description": {
          "type": "string"
        },
        "details_tags": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "visuals_images": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "url"
            ],
            "properties": {
              "tag": {
                "type": "string"
              },
              "url": {
                "type": "string"
              }
            },
            "additionalProperties": true
          }
        },
        "visuals_videos": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "url"
            ],
            "properties": {
              "tag": {
                "type": "string"
              },
              "url": {
                "type": "string"
              }
            },
            "additionalProperties": true
          }
        },
        "details_category": {
          "type": "string"
        },
        "details_sections": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "identification_sKU": {
          "type": "string"
        },
        "details_subCategory": {
          "type": "string"
        },
        "details_subCategory2": {
          "type": "string"
        },
        "details_offerCategory": {
          "type": "string"
        },
        "details_personalisation": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "identification_productId": {
          "type": "string"
        },
        "identification_productIdType": {
          "type": "string"
        },
        "productionInformation_brandName": {
          "type": "string"
        },
        "productionInformation_materials": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "productionInformation_modelNumber": {
          "type": "string"
        },
        "productionInformation_manufacturer": {
          "type": "string"
        },
        "productionInformation_manufacturerPartNumber": {
          "type": "string"
        }
      },
      "additionalProperties": true
    },
    "configId": {
      "type": "string",
      "description": "Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid values for this server."
    },
    "shipping": {
      "type": "object",
      "required": [
        "returnPeriod"
      ],
      "properties": {
        "returnPeriod": {
          "type": "string"
        },
        "defaultVersion": {
          "type": "number"
        },
        "countryOfOrigin": {
          "type": "string"
        },
        "redemptionPoint": {
          "type": "string"
        },
        "supportedJurisdictions": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "label",
              "deliveryTime"
            ],
            "properties": {
              "label": {
                "type": "string"
              },
              "deliveryTime": {
                "type": "string"
              }
            },
            "additionalProperties": true
          }
        }
      },
      "additionalProperties": true
    },
    "schemaUrl": {
      "type": "string"
    },
    "variations": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "type",
          "option"
        ],
        "properties": {
          "type": {
            "type": "string"
          },
          "option": {
            "type": "string"
          }
        },
        "additionalProperties": true
      }
    },
    "signerAddress": {
      "type": "string",
      "description": "Ethereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally."
    },
    "exchangePolicy": {
      "type": "object",
      "required": [
        "uuid",
        "version",
        "template",
        "sellerContactMethod",
        "disputeResolverContactMethod"
      ],
      "properties": {
        "uuid": {
          "type": "string"
        },
        "label": {
          "type": "string"
        },
        "version": {
          "type": "number"
        },
        "template": {
          "type": "string"
        },
        "sellerContactMethod": {
          "type": "string"
        },
        "disputeResolverContactMethod": {
          "type": "string"
        }
      },
      "additionalProperties": true
    },
    "productOverrides": {
      "type": "object",
      "properties": {
        "title": {
          "type": "string"
        },
        "description": {
          "type": "string"
        },
        "visuals_images": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "url"
            ],
            "properties": {
              "tag": {
                "type": "string"
              },
              "url": {
                "type": "string"
              }
            },
            "additionalProperties": true
          }
        },
        "visuals_videos": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "url"
            ],
            "properties": {
              "tag": {
                "type": "string"
              },
              "url": {
                "type": "string"
              }
            },
            "additionalProperties": true
          }
        },
        "identification_sKU": {
          "type": "string"
        },
        "identification_productId": {
          "type": "string"
        },
        "identification_productIdType": {
          "type": "string"
        },
        "productionInformation_brandName": {
          "type": "string"
        },
        "productionInformation_materials": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "productionInformation_modelNumber": {
          "type": "string"
        },
        "productionInformation_manufacturer": {
          "type": "string"
        },
        "productionInformation_manufacturerPartNumber": {
          "type": "string"
        }
      },
      "additionalProperties": true
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "schemaUrl",
    "type",
    "name",
    "description",
    "externalUrl",
    "licenseUrl",
    "bundleUuid",
    "seller",
    "items",
    "configId",
    "signerAddress"
  ],
  "properties": {
    "name": {
      "type": "string"
    },
    "type": {
      "enum": [
        "BUNDLE"
      ],
      "type": "string"
    },
    "image": {
      "type": "string"
    },
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string"
          }
        },
        "additionalProperties": true
      }
    },
    "seller": {
      "type": "object",
      "required": [
        "defaultVersion",
        "name",
        "contactLinks"
      ],
      "properties": {
        "name": {
          "type": "string"
        },
        "images": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "url"
            ],
            "properties": {
              "tag": {
                "type": "string"
              },
              "url": {
                "type": "string"
              }
            },
            "additionalProperties": true
          }
        },
        "tokenId": {
          "type": "string"
        },
        "description": {
          "type": "string"
        },
        "externalUrl": {
          "type": "string"
        },
        "contactLinks": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "url",
              "tag"
            ],
            "properties": {
              "tag": {
                "type": "string"
              },
              "url": {
                "type": "string"
              }
            },
            "additionalProperties": true
          }
        },
        "defaultVersion": {
          "type": "number"
        }
      },
      "additionalProperties": true
    },
    "configId": {
      "type": "string",
      "description": "Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid values for this server."
    },
    "condition": {
      "type": "string"
    },
    "imageData": {
      "type": "string"
    },
    "schemaUrl": {
      "type": "string"
    },
    "attributes": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "traitType",
          "value"
        ],
        "properties": {
          "value": {
            "type": "string"
          },
          "traitType": {
            "type": "string"
          },
          "displayType": {
            "type": "string"
          }
        },
        "additionalProperties": true
      }
    },
    "bundleUuid": {
      "type": "string"
    },
    "licenseUrl": {
      "type": "string"
    },
    "youtubeUrl": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "externalUrl": {
      "type": "string"
    },
    "animationUrl": {
      "type": "string"
    },
    "signerAddress": {
      "type": "string",
      "description": "Ethereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "schemaUrl",
    "type",
    "uuid",
    "name",
    "description",
    "externalUrl",
    "licenseUrl",
    "image",
    "attributes",
    "product",
    "seller",
    "shipping",
    "exchangePolicy",
    "configId",
    "signerAddress"
  ],
  "properties": {
    "name": {
      "type": "string"
    },
    "type": {
      "enum": [
        "PRODUCT_V1"
      ],
      "type": "string"
    },
    "uuid": {
      "type": "string"
    },
    "image": {
      "type": "string"
    },
    "seller": {
      "type": "object",
      "required": [
        "defaultVersion",
        "name",
        "contactLinks"
      ],
      "properties": {
        "name": {
          "type": "string"
        },
        "images": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "url"
            ],
            "properties": {
              "tag": {
                "type": "string"
              },
              "url": {
                "type": "string"
              }
            },
            "additionalProperties": true
          }
        },
        "tokenId": {
          "type": "string"
        },
        "description": {
          "type": "string"
        },
        "externalUrl": {
          "type": "string"
        },
        "contactLinks": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "url",
              "tag"
            ],
            "properties": {
              "tag": {
                "type": "string"
              },
              "url": {
                "type": "string"
              }
            },
            "additionalProperties": true
          }
        },
        "defaultVersion": {
          "type": "number"
        }
      },
      "additionalProperties": true
    },
    "product": {
      "type": "object",
      "required": [
        "uuid",
        "version",
        "title",
        "description",
        "productionInformation_brandName",
        "details_offerCategory",
        "visuals_images"
      ],
      "properties": {
        "uuid": {
          "type": "string"
        },
        "title": {
          "type": "string"
        },
        "version": {
          "type": "number"
        },
        "description": {
          "type": "string"
        },
        "details_tags": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "visuals_images": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "url"
            ],
            "properties": {
              "tag": {
                "type": "string"
              },
              "url": {
                "type": "string"
              }
            },
            "additionalProperties": true
          }
        },
        "visuals_videos": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "url"
            ],
            "properties": {
              "tag": {
                "type": "string"
              },
              "url": {
                "type": "string"
              }
            },
            "additionalProperties": true
          }
        },
        "details_category": {
          "type": "string"
        },
        "details_sections": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "identification_sKU": {
          "type": "string"
        },
        "details_subCategory": {
          "type": "string"
        },
        "details_subCategory2": {
          "type": "string"
        },
        "details_offerCategory": {
          "type": "string"
        },
        "details_personalisation": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "identification_productId": {
          "type": "string"
        },
        "identification_productIdType": {
          "type": "string"
        },
        "productionInformation_brandName": {
          "type": "string"
        },
        "productionInformation_materials": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "productionInformation_modelNumber": {
          "type": "string"
        },
        "productionInformation_manufacturer": {
          "type": "string"
        },
        "productionInformation_manufacturerPartNumber": {
          "type": "string"
        }
      },
      "additionalProperties": true
    },
    "configId": {
      "type": "string",
      "description": "Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid values for this server."
    },
    "shipping": {
      "type": "object",
      "required": [
        "returnPeriod"
      ],
      "properties": {
        "returnPeriod": {
          "type": "string"
        },
        "defaultVersion": {
          "type": "number"
        },
        "countryOfOrigin": {
          "type": "string"
        },
        "redemptionPoint": {
          "type": "string"
        },
        "supportedJurisdictions": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "label",
              "deliveryTime"
            ],
            "properties": {
              "label": {
                "type": "string"
              },
              "deliveryTime": {
                "type": "string"
              }
            },
            "additionalProperties": true
          }
        }
      },
      "additionalProperties": true
    },
    "condition": {
      "type": "string"
    },
    "imageData": {
      "type": "string"
    },
    "schemaUrl": {
      "type": "string"
    },
    "attributes": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "traitType",
          "value"
        ],
        "properties": {
          "value": {
            "type": "string"
          },
          "traitType": {
            "type": "string"
          },
          "displayType": {
            "type": "string"
          }
        },
        "additionalProperties": true
      }
    },
    "licenseUrl": {
      "type": "string"
    },
    "variations": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "type",
          "option"
        ],
        "properties": {
          "type": {
            "type": "string"
          },
          "option": {
            "type": "string"
          }
        },
        "additionalProperties": true
      }
    },
    "youtubeUrl": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "externalUrl": {
      "type": "string"
    },
    "animationUrl": {
      "type": "string"
    },
    "signerAddress": {
      "type": "string",
      "description": "Ethereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally."
    },
    "exchangePolicy": {
      "type": "object",
      "required": [
        "uuid",
        "version",
        "template",
        "sellerContactMethod",
        "disputeResolverContactMethod"
      ],
      "properties": {
        "uuid": {
          "type": "string"
        },
        "label": {
          "type": "string"
        },
        "version": {
          "type": "number"
        },
        "template": {
          "type": "string"
        },
        "sellerContactMethod": {
          "type": "string"
        },
        "disputeResolverContactMethod": {
          "type": "string"
        }
      },
      "additionalProperties": true
    },
    "productOverrides": {
      "type": "object",
      "properties": {
        "title": {
          "type": "string"
        },
        "description": {
          "type": "string"
        },
        "visuals_images": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "url"
            ],
            "properties": {
              "tag": {
                "type": "string"
              },
              "url": {
                "type": "string"
              }
            },
            "additionalProperties": true
          }
        },
        "visuals_videos": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "url"
            ],
            "properties": {
              "tag": {
                "type": "string"
              },
              "url": {
                "type": "string"
              }
            },
            "additionalProperties": true
          }
        },
        "identification_sKU": {
          "type": "string"
        },
        "identification_productId": {
          "type": "string"
        },
        "identification_productIdType": {
          "type": "string"
        },
        "productionInformation_brandName": {
          "type": "string"
        },
        "productionInformation_materials": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "productionInformation_modelNumber": {
          "type": "string"
        },
        "productionInformation_manufacturer": {
          "type": "string"
        },
        "productionInformation_manufacturerPartNumber": {
          "type": "string"
        }
      },
      "additionalProperties": true
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "type",
    "kind",
    "contactPreference",
    "authTokenId",
    "authTokenType",
    "id",
    "configId",
    "signerAddress"
  ],
  "properties": {
    "id": {
      "$ref": "#/properties/authTokenId",
      "description": "Numeric ID of the existing seller entity to update. Obtain from get_sellers_by_address."
    },
    "kind": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "type": {
      "type": "string"
    },
    "images": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "url",
          "type"
        ],
        "properties": {
          "fit": {
            "type": "string"
          },
          "tag": {
            "type": "string"
          },
          "url": {
            "type": "string"
          },
          "type": {
            "type": "string"
          },
          "width": {
            "type": "number"
          },
          "height": {
            "type": "number"
          },
          "position": {
            "type": "string"
          }
        },
        "additionalProperties": true
      }
    },
    "website": {
      "type": "string"
    },
    "configId": {
      "type": "string",
      "description": "Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid values for this server."
    },
    "authTokenId": {
      "type": "string",
      "description": "NFT token ID used as auth token (e.g. Lens profile ID). Pass '0' if not using auth tokens."
    },
    "description": {
      "type": "string"
    },
    "socialLinks": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "url",
          "tag"
        ],
        "properties": {
          "tag": {
            "type": "string"
          },
          "url": {
            "type": "string"
          }
        },
        "additionalProperties": true
      }
    },
    "contactLinks": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "url",
          "tag"
        ],
        "properties": {
          "tag": {
            "type": "string"
          },
          "url": {
            "type": "string"
          }
        },
        "additionalProperties": true
      }
    },
    "authTokenType": {
      "type": "number",
      "description": "Auth token type: 0=None, 1=Lens Protocol profile NFT."
    },
    "executionMode": {
      "enum": [
        "direct",
        "metaTx"
      ],
      "type": "string",
      "description": "'direct' = standard on-chain tx (sign locally with your wallet → send_signed_transaction). 'metaTx' = gasless relay via Biconomy (send_meta_transaction). Defaults to 'direct'."
    },
    "salesChannels": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "tag"
        ],
        "properties": {
          "tag": {
            "type": "string"
          },
          "link": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "deployments": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "link": {
                  "type": "string"
                },
                "status": {
                  "type": "string"
                },
                "product": {
                  "type": "object",
                  "properties": {
                    "uuid": {
                      "type": "string"
                    },
                    "version": {
                      "type": "number"
                    }
                  },
                  "additionalProperties": false
                },
                "lastUpdated": {
                  "type": "string"
                }
              },
              "additionalProperties": false
            }
          },
          "settingsUrl": {
            "type": "string"
          },
          "settingsEditor": {
            "type": "string"
          }
        },
        "additionalProperties": true
      }
    },
    "signerAddress": {
      "type": "string",
      "description": "Ethereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally."
    },
    "legalTradingName": {
      "type": "string"
    },
    "contactPreference": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "sellerId",
    "buyerId",
    "metadataUri",
    "metadataHash",
    "price",
    "sellerDeposit",
    "buyerCancellationPenalty",
    "quantityAvailable",
    "validFromDateInMS",
    "validUntilDateInMS",
    "voucherRedeemableFromDateInMS",
    "voucherRedeemableUntilDateInMS",
    "disputePeriodDurationInMS",
    "voucherValidDurationInMS",
    "resolutionPeriodDurationInMS",
    "configId",
    "signerAddress"
  ],
  "properties": {
    "price": {
      "$ref": "#/properties/condition/properties/minTokenId",
      "description": "Offer price in the exchange token's smallest unit (wei). Pass as string to avoid precision loss, e.g. '1000000000000000000' = 1 ETH."
    },
    "agentId": {
      "$ref": "#/properties/condition/properties/minTokenId",
      "description": "Optional dACP agent facilitating this offer. Omit or pass '0' if no agent."
    },
    "buyerId": {
      "$ref": "#/properties/condition/properties/minTokenId",
      "description": "Numeric ID of the buyer entity. Use '0' for seller-initiated offers."
    },
    "creator": {
      "enum": [
        "SELLER",
        "BUYER"
      ],
      "type": "string",
      "description": "'SELLER' (default) = seller creates offer. 'BUYER' = buyer-initiated offer, quantity must be 1."
    },
    "configId": {
      "type": "string",
      "description": "Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid values for this server."
    },
    "feeLimit": {
      "$ref": "#/properties/agentId",
      "description": "Max protocol fee the seller accepts in same token unit. Pass as string."
    },
    "sellerId": {
      "$ref": "#/properties/condition/properties/minTokenId",
      "description": "Numeric ID of the seller entity. Obtain via get_sellers_by_address."
    },
    "condition": {
      "type": "object",
      "required": [
        "method",
        "tokenType",
        "tokenAddress",
        "gatingType",
        "minTokenId",
        "maxTokenId",
        "threshold",
        "maxCommits"
      ],
      "properties": {
        "method": {
          "type": "number",
          "description": "Gating method: 0=None, 1=Threshold (hold >= threshold tokens), 2=SpecificToken (hold specific token ID)."
        },
        "threshold": {
          "$ref": "#/properties/condition/properties/minTokenId",
          "description": "Minimum token balance required. Pass as string."
        },
        "tokenType": {
          "type": "number",
          "description": "Token standard: 0=ERC-20, 1=ERC-721, 2=ERC-1155."
        },
        "gatingType": {
          "type": "number",
          "description": "0=PerAddress (each address commits once), 1=PerTokenId (each token ID can be used once)."
        },
        "maxCommits": {
          "$ref": "#/properties/condition/properties/minTokenId",
          "description": "Max commits per qualifying address or token ID. Pass as string."
        },
        "maxTokenId": {
          "$ref": "#/properties/condition/properties/minTokenId",
          "description": "Max token ID (inclusive) for ERC-721/1155 criteria. Pass as string."
        },
        "minTokenId": {
          "type": "string",
          "description": "Min token ID (inclusive) for ERC-721/1155 criteria. Pass as string."
        },
        "tokenAddress": {
          "type": "string",
          "description": "Address of the gate token contract buyers must hold."
        }
      },
      "additionalProperties": false
    },
    "priceType": {
      "type": "number",
      "description": "0 = static price, 1 = discovery price (auction)."
    },
    "metadataUri": {
      "type": "string",
      "description": "IPFS URI pointing to the offer metadata JSON. Obtain by calling store_product_v1_metadata, store_bundle_metadata, or store_base_metadata."
    },
    "royaltyInfo": {
      "type": "object",
      "required": [
        "recipients",
        "bps"
      ],
      "properties": {
        "bps": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "minItems": 0,
          "description": "Royalty amounts per recipient in basis points (1 bp = 0.01%). Parallel to recipients. Total must not exceed 10000."
        },
        "recipients": {
          "type": "array",
          "items": {
            "$ref": "#/properties/exchangeTokenAddress"
          },
          "minItems": 0,
          "description": "Array of addresses receiving resale royalties."
        }
      },
      "additionalProperties": false
    },
    "metadataHash": {
      "type": "string",
      "description": "Keccak256 hash of the metadata JSON. Returned alongside metadataUri from the store_*_metadata tools."
    },
    "executionMode": {
      "enum": [
        "direct",
        "metaTx"
      ],
      "type": "string",
      "description": "'direct' = standard on-chain tx (sign locally with your wallet → send_signed_transaction). 'metaTx' = gasless relay via Biconomy (send_meta_transaction). Defaults to 'direct'."
    },
    "sellerDeposit": {
      "$ref": "#/properties/condition/properties/minTokenId",
      "description": "Seller collateral in same unit as price. Released to seller on completion or forfeited on dispute. Pass as string."
    },
    "signerAddress": {
      "$ref": "#/properties/condition/properties/tokenAddress",
      "description": "Ethereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally."
    },
    "collectionIndex": {
      "$ref": "#/properties/agentId",
      "description": "Index of the seller's NFT collection for vouchers. Omit to use default (index 0)."
    },
    "disputeResolverId": {
      "type": "string",
      "description": "ID of the dispute resolver for escalated disputes. Call get_dispute_resolvers to list available resolvers."
    },
    "quantityAvailable": {
      "type": "number",
      "description": "How many times this offer can be committed to. Must be 1 when creator='BUYER'.",
      "exclusiveMinimum": 0
    },
    "useDepositedFunds": {
      "type": "boolean",
      "description": "If true, use funds already deposited in the protocol treasury instead of transferring from the wallet."
    },
    "validFromDateInMS": {
      "type": "number",
      "description": "Unix timestamp in milliseconds when the offer becomes active. Example: Date.now() for immediate."
    },
    "validUntilDateInMS": {
      "type": "number",
      "description": "Unix timestamp in milliseconds when the offer can no longer be committed to."
    },
    "drMutualizerAddress": {
      "$ref": "#/properties/exchangeTokenAddress",
      "description": "Optional dispute resolver mutualizer contract address that pools resolution funds."
    },
    "exchangeTokenAddress": {
      "$ref": "#/properties/condition/properties/tokenAddress",
      "description": "ERC-20 token accepted for payment. Omit or use address(0) for native ETH. Call get_supported_tokens for valid values."
    },
    "buyerCancellationPenalty": {
      "$ref": "#/properties/condition/properties/minTokenId",
      "description": "Amount buyer forfeits on cancel, in same unit as price. Must be <= price. Pass as string."
    },
    "voucherValidDurationInMS": {
      "type": "number",
      "description": "Voucher is redeemable for this many ms after commit. Set to 0 to use voucherRedeemableUntilDateInMS instead."
    },
    "disputePeriodDurationInMS": {
      "type": "number",
      "description": "Duration in ms for buyer to raise a dispute after redeeming. Example: 604800000 = 7 days."
    },
    "resolutionPeriodDurationInMS": {
      "type": "number",
      "description": "Duration in ms to respond to a resolution proposal before it expires. Example: 259200000 = 3 days."
    },
    "voucherRedeemableFromDateInMS": {
      "type": "number",
      "description": "Timestamp in ms from which buyer can redeem. Must be >= validFromDateInMS."
    },
    "voucherRedeemableUntilDateInMS": {
      "type": "number",
      "description": "Timestamp in ms after which voucher cannot be redeemed. Set to 0 to use voucherValidDurationInMS instead."
    }
  },
  "additionalProperties": false
}