{
  "openapi": "3.1.1",
  "info": {
    "title": "GAMA Agent Launch API",
    "version": "1.2.0",
    "description": "Provider-independent launch preparation. The caller owns signing and broadcasting. No API operation spends funds. Secrets belong only in headers or private wallet configuration."
  },
  "externalDocs": {
    "url": "https://launch.gama.win/api",
    "description": "GAMA API access and launch tools"
  },
  "servers": [
    {
      "url": "https://launch.gama.win/api/v1",
      "description": "Public GIWA Sepolia"
    },
    {
      "url": "/api/v1",
      "description": "Current origin; staging uses its own configured gate, credentials and contracts"
    }
  ],
  "components": {
    "securitySchemes": {
      "DeveloperKey": {
        "type": "apiKey",
        "in": "header",
        "name": "X-Gama-Key"
      }
    },
    "schemas": {
      "LaunchConfig": {
        "type": "object",
        "properties": {
          "creator": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]{40}$"
          },
          "quote": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]{40}$"
          },
          "creator_recipient": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]{40}$"
          },
          "reward_mode": {
            "type": "boolean",
            "default": false
          },
          "creator_tax_bps": {
            "type": "integer",
            "minimum": 0,
            "maximum": 900,
            "default": 0
          },
          "holder_fee_bps": {
            "type": "integer",
            "minimum": 0,
            "maximum": 400
          },
          "opening_quote": {
            "type": "string",
            "pattern": "^(0|[1-9][0-9]{0,77})$",
            "default": "0"
          },
          "slippage_bps": {
            "type": "integer",
            "minimum": 0,
            "maximum": 500,
            "default": 50
          },
          "exemptions": {
            "type": "array",
            "maxItems": 32,
            "uniqueItems": true,
            "items": {
              "type": "string",
              "pattern": "^0x[0-9a-fA-F]{40}$"
            }
          },
          "lock": {
            "type": "array",
            "maxItems": 64,
            "items": {
              "type": "object",
              "properties": {
                "time": {
                  "type": "string",
                  "pattern": "^(0|[1-9][0-9]{0,77})$"
                },
                "share": {
                  "type": "string",
                  "pattern": "^(0|[1-9][0-9]{0,77})$"
                }
              },
              "required": [
                "time",
                "share"
              ],
              "additionalProperties": false
            }
          },
          "metadata": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "minLength": 1,
                "maxLength": 64
              },
              "symbol": {
                "type": "string",
                "minLength": 1,
                "maxLength": 16
              },
              "description": {
                "type": "string",
                "maxLength": 2048
              },
              "logo": {
                "type": "string",
                "maxLength": 512
              },
              "socials": {
                "type": "object",
                "properties": {
                  "twitter": {
                    "type": "string",
                    "maxLength": 256
                  },
                  "telegram": {
                    "type": "string",
                    "maxLength": 256
                  },
                  "discord": {
                    "type": "string",
                    "maxLength": 256
                  },
                  "website": {
                    "type": "string",
                    "maxLength": 256
                  },
                  "farcaster": {
                    "type": "string",
                    "maxLength": 256
                  }
                },
                "required": [],
                "additionalProperties": false
              }
            },
            "required": [
              "name",
              "symbol"
            ],
            "additionalProperties": false
          },
          "creator_shares": {
            "$ref": "#/components/schemas/CreatorShares"
          }
        },
        "required": [
          "creator",
          "metadata"
        ],
        "additionalProperties": false
      },
      "Lifecycle": {
        "type": "object",
        "properties": {
          "preparation": {
            "enum": [
              "none",
              "expired",
              "reviewable"
            ]
          },
          "expires_at": {
            "type": [
              "integer",
              "null"
            ]
          },
          "transaction": {
            "enum": [
              "confirmed",
              "pending_or_unknown",
              "not_observed"
            ]
          },
          "indexing": {
            "enum": [
              "indexed",
              "waiting",
              "not_applicable"
            ]
          },
          "finality": {
            "enum": [
              "unknown",
              "unfinalized",
              "finalized"
            ]
          },
          "occupies_slot": {
            "type": "boolean"
          },
          "next_action": {
            "type": "string"
          },
          "archive_requires_finality": {
            "type": "boolean"
          }
        },
        "required": [
          "preparation",
          "expires_at",
          "transaction",
          "indexing",
          "finality",
          "occupies_slot",
          "next_action",
          "archive_requires_finality"
        ],
        "additionalProperties": false
      },
      "Usage": {
        "type": "object",
        "properties": {
          "schema": {
            "const": "gama-usage/1"
          },
          "as_of": {
            "type": "integer"
          },
          "wallet": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]{40}$"
          },
          "key_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "limits": {
            "type": "object",
            "properties": {
              "keys": {
                "const": 1
              },
              "active_intents": {
                "const": 1
              }
            },
            "required": [
              "keys",
              "active_intents"
            ],
            "additionalProperties": false
          },
          "unfinished_launch": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/IntentSummary"
              },
              {
                "type": "null"
              }
            ]
          },
          "quotas": {
            "type": "object",
            "properties": {
              "reads": {
                "type": "object",
                "properties": {
                  "limit": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "used": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "remaining": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "window_seconds": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "resets_at": {
                    "type": "integer",
                    "minimum": 0
                  }
                },
                "required": [
                  "limit",
                  "used",
                  "remaining",
                  "window_seconds",
                  "resets_at"
                ],
                "additionalProperties": false
              },
              "preparations": {
                "type": "object",
                "properties": {
                  "limit": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "used": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "remaining": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "window_seconds": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "resets_at": {
                    "type": "integer",
                    "minimum": 0
                  }
                },
                "required": [
                  "limit",
                  "used",
                  "remaining",
                  "window_seconds",
                  "resets_at"
                ],
                "additionalProperties": false
              },
              "uploads": {
                "type": "object",
                "properties": {
                  "limit": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "used": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "remaining": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "window_seconds": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "resets_at": {
                    "type": "integer",
                    "minimum": 0
                  }
                },
                "required": [
                  "limit",
                  "used",
                  "remaining",
                  "window_seconds",
                  "resets_at"
                ],
                "additionalProperties": false
              },
              "recovery": {
                "type": "object",
                "properties": {
                  "limit": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "used": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "remaining": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "window_seconds": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "resets_at": {
                    "type": "integer",
                    "minimum": 0
                  }
                },
                "required": [
                  "limit",
                  "used",
                  "remaining",
                  "window_seconds",
                  "resets_at"
                ],
                "additionalProperties": false
              },
              "intents": {
                "type": "object",
                "properties": {
                  "limit": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "used": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "remaining": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "window_seconds": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "resets_at": {
                    "type": "integer",
                    "minimum": 0
                  }
                },
                "required": [
                  "limit",
                  "used",
                  "remaining",
                  "window_seconds",
                  "resets_at"
                ],
                "additionalProperties": false
              },
              "management": {
                "type": "object",
                "properties": {
                  "limit": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "used": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "remaining": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "window_seconds": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "resets_at": {
                    "type": "integer",
                    "minimum": 0
                  }
                },
                "required": [
                  "limit",
                  "used",
                  "remaining",
                  "window_seconds",
                  "resets_at"
                ],
                "additionalProperties": false
              },
              "streams": {
                "type": "object",
                "properties": {
                  "limit": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "used": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "remaining": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "window_seconds": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "resets_at": {
                    "type": "integer",
                    "minimum": 0
                  }
                },
                "required": [
                  "limit",
                  "used",
                  "remaining",
                  "window_seconds",
                  "resets_at"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "reads",
              "preparations",
              "uploads",
              "recovery",
              "intents",
              "management",
              "streams"
            ],
            "additionalProperties": false
          },
          "public_reads": {
            "const": "separate_public_limits"
          },
          "preparation_available": {
            "type": "boolean"
          }
        },
        "required": [
          "schema",
          "as_of",
          "wallet",
          "key_id",
          "limits",
          "unfinished_launch",
          "quotas",
          "public_reads",
          "preparation_available"
        ],
        "additionalProperties": false
      },
      "UnsignedTransaction": {
        "type": "object",
        "properties": {
          "chain_id": {
            "type": "integer"
          },
          "from": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]{40}$"
          },
          "to": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]{40}$"
          },
          "data": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]*$"
          },
          "value": {
            "type": "string",
            "pattern": "^(0|[1-9][0-9]{0,77})$"
          }
        },
        "required": [
          "chain_id",
          "from",
          "to",
          "data",
          "value"
        ],
        "additionalProperties": false
      },
      "Recovery": {
        "type": "object",
        "properties": {
          "state": {
            "enum": [
              "confirmed",
              "pending_or_unknown",
              "not_created"
            ]
          },
          "token": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]{40}$"
          },
          "curve": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]{40}$"
          },
          "chain_id": {
            "type": "integer"
          },
          "block": {
            "type": "string",
            "pattern": "^(0|[1-9][0-9]{0,77})$"
          },
          "block_hash": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]*$"
          },
          "finality": {
            "enum": [
              "unknown",
              "unfinalized",
              "finalized"
            ]
          },
          "transactions": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "hash": {
                  "type": "string",
                  "pattern": "^0x[0-9a-fA-F]*$"
                },
                "state": {
                  "enum": [
                    "pending_or_unknown",
                    "reorged",
                    "reverted",
                    "mined"
                  ]
                },
                "block": {
                  "type": "string",
                  "pattern": "^(0|[1-9][0-9]{0,77})$"
                }
              },
              "required": [
                "hash",
                "state"
              ],
              "additionalProperties": false
            }
          }
        },
        "required": [
          "state"
        ],
        "additionalProperties": false
      },
      "Plan": {
        "type": "object",
        "properties": {
          "chain_id": {
            "type": "integer"
          },
          "factory": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]{40}$"
          },
          "source_commit": {
            "type": "string"
          },
          "deployment": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]*$"
          },
          "schema": {
            "const": "gama-launch/1"
          },
          "intent_id": {
            "type": "string",
            "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
          },
          "config_hash": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]*$"
          },
          "creator": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]{40}$"
          },
          "curve": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]{40}$"
          },
          "token": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]{40}$"
          },
          "prepared_at": {
            "type": "integer"
          },
          "review_block": {
            "type": "string",
            "pattern": "^(0|[1-9][0-9]{0,77})$"
          },
          "review_block_hash": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]*$"
          },
          "gas_note": {
            "type": "string"
          },
          "request": {
            "type": "object",
            "properties": {
              "metadata": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 64
                  },
                  "symbol": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 16
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 2048
                  },
                  "logo": {
                    "type": "string",
                    "maxLength": 512
                  },
                  "socials": {
                    "type": "object",
                    "properties": {
                      "twitter": {
                        "type": "string",
                        "maxLength": 256
                      },
                      "telegram": {
                        "type": "string",
                        "maxLength": 256
                      },
                      "discord": {
                        "type": "string",
                        "maxLength": 256
                      },
                      "website": {
                        "type": "string",
                        "maxLength": 256
                      },
                      "farcaster": {
                        "type": "string",
                        "maxLength": 256
                      }
                    },
                    "required": [],
                    "additionalProperties": false
                  }
                },
                "required": [
                  "name",
                  "symbol"
                ],
                "additionalProperties": false
              },
              "quote": {
                "type": "string",
                "pattern": "^0x[0-9a-fA-F]{40}$"
              },
              "creatorRecipient": {
                "type": "string",
                "pattern": "^0x[0-9a-fA-F]{40}$"
              },
              "openingRecipient": {
                "type": "string",
                "pattern": "^0x[0-9a-fA-F]{40}$"
              },
              "rewardMode": {
                "type": "boolean"
              },
              "creatorTaxBps": {
                "type": "integer"
              },
              "holderFeeBps": {
                "type": "integer"
              },
              "exemptions": {
                "type": "array",
                "items": {
                  "type": "string",
                  "pattern": "^0x[0-9a-fA-F]{40}$"
                }
              },
              "curveSalt": {
                "type": "string",
                "pattern": "^0x[0-9a-fA-F]*$"
              },
              "tokenSalt": {
                "type": "string",
                "pattern": "^0x[0-9a-fA-F]*$"
              },
              "openingQuote": {
                "type": "string",
                "pattern": "^(0|[1-9][0-9]{0,77})$"
              },
              "minimumOpeningTokens": {
                "type": "string",
                "pattern": "^(0|[1-9][0-9]{0,77})$"
              },
              "deadline": {
                "type": "string",
                "pattern": "^(0|[1-9][0-9]{0,77})$"
              },
              "referenceTarget": {
                "type": "string",
                "pattern": "^(0|[1-9][0-9]{0,77})$"
              }
            },
            "required": [
              "metadata",
              "quote",
              "creatorRecipient",
              "openingRecipient",
              "rewardMode",
              "creatorTaxBps",
              "holderFeeBps",
              "exemptions",
              "curveSalt",
              "tokenSalt",
              "openingQuote",
              "minimumOpeningTokens",
              "deadline",
              "referenceTarget"
            ],
            "additionalProperties": false
          },
          "preview": {
            "type": "object",
            "description": "Factory preview tuple from the pinned ABI. All uint128/256 values are decimal strings; uint16 values are integers.",
            "properties": {
              "token": {
                "type": "string",
                "pattern": "^0x[0-9a-fA-F]{40}$"
              },
              "curve": {
                "type": "string",
                "pattern": "^0x[0-9a-fA-F]{40}$"
              },
              "tokenInitCodeHash": {
                "type": "string",
                "pattern": "^0x[0-9a-fA-F]*$"
              },
              "commitment": {
                "type": "string",
                "pattern": "^0x[0-9a-fA-F]*$"
              },
              "referenceTarget": {
                "type": "string",
                "pattern": "^(0|[1-9][0-9]{0,77})$"
              },
              "terms": {
                "type": "object"
              },
              "curveConfig": {
                "type": "object"
              }
            }
          },
          "approval": {
            "anyOf": [
              {
                "type": "null"
              },
              {
                "type": "object",
                "properties": {
                  "chain_id": {
                    "type": "integer"
                  },
                  "from": {
                    "type": "string",
                    "pattern": "^0x[0-9a-fA-F]{40}$"
                  },
                  "to": {
                    "type": "string",
                    "pattern": "^0x[0-9a-fA-F]{40}$"
                  },
                  "data": {
                    "type": "string",
                    "pattern": "^0x[0-9a-fA-F]*$"
                  },
                  "value": {
                    "type": "string",
                    "pattern": "^(0|[1-9][0-9]{0,77})$"
                  },
                  "spender": {
                    "type": "string",
                    "pattern": "^0x[0-9a-fA-F]{40}$"
                  },
                  "amount": {
                    "type": "string",
                    "pattern": "^(0|[1-9][0-9]{0,77})$"
                  },
                  "reset": {
                    "$ref": "#/components/schemas/UnsignedTransaction"
                  }
                },
                "required": [
                  "chain_id",
                  "from",
                  "to",
                  "data",
                  "value",
                  "spender",
                  "amount",
                  "reset"
                ],
                "additionalProperties": false
              }
            ]
          },
          "transaction": {
            "$ref": "#/components/schemas/UnsignedTransaction"
          },
          "simulation": {
            "type": "object",
            "properties": {
              "state": {
                "enum": [
                  "passed",
                  "approval_required",
                  "wallet_execution_required",
                  "refused"
                ]
              },
              "gas": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "code": {
                "type": "string"
              },
              "next_action": {
                "type": "string"
              },
              "requirements": {
                "type": "array",
                "maxItems": 2,
                "items": {
                  "type": "object",
                  "properties": {
                    "asset": {
                      "type": "string",
                      "pattern": "^0x[0-9a-fA-F]{40}$"
                    },
                    "required": {
                      "type": "string",
                      "pattern": "^(0|[1-9][0-9]{0,77})$"
                    },
                    "available": {
                      "type": "string",
                      "pattern": "^(0|[1-9][0-9]{0,77})$"
                    },
                    "includes_gas": {
                      "const": false
                    }
                  },
                  "required": [
                    "asset",
                    "required",
                    "available",
                    "includes_gas"
                  ],
                  "additionalProperties": false
                }
              }
            },
            "required": [
              "state",
              "gas"
            ],
            "additionalProperties": false
          },
          "creator_shares": {
            "$ref": "#/components/schemas/CreatorShares"
          },
          "creator_policy_version": {
            "type": "string",
            "pattern": "^(0|[1-9][0-9]{0,77})$"
          }
        },
        "required": [
          "schema",
          "chain_id",
          "factory",
          "source_commit",
          "deployment",
          "intent_id",
          "config_hash",
          "creator",
          "curve",
          "token",
          "prepared_at",
          "review_block",
          "review_block_hash",
          "request",
          "preview",
          "approval",
          "transaction",
          "simulation",
          "gas_note"
        ],
        "additionalProperties": false
      },
      "IntentSummary": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
          },
          "status": {
            "enum": [
              "draft",
              "prepared",
              "pending",
              "confirmed",
              "failed"
            ]
          },
          "created": {
            "type": "integer"
          },
          "updated": {
            "type": "integer"
          }
        },
        "required": [
          "id",
          "status",
          "created",
          "updated"
        ],
        "additionalProperties": false
      },
      "Intent": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
          },
          "status": {
            "enum": [
              "draft",
              "prepared",
              "pending",
              "confirmed",
              "failed"
            ]
          },
          "created": {
            "type": "integer"
          },
          "updated": {
            "type": "integer"
          },
          "owner": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]{40}$"
          },
          "config": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/LaunchConfig"
              },
              {
                "$ref": "#/components/schemas/SaleConfig"
              }
            ]
          },
          "fingerprint": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]*$"
          },
          "salt": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]*$"
          },
          "attempts": {
            "type": "array",
            "items": {
              "anyOf": [
                {
                  "$ref": "#/components/schemas/Plan"
                },
                {
                  "$ref": "#/components/schemas/SaleCreationPlan"
                }
              ]
            },
            "maxItems": 12
          },
          "transactions": {
            "type": "array",
            "items": {
              "type": "string",
              "pattern": "^0x[0-9a-fA-F]*$"
            },
            "maxItems": 24
          },
          "recovery": {
            "$ref": "#/components/schemas/Recovery"
          },
          "indexed": {
            "type": "boolean"
          },
          "lifecycle": {
            "$ref": "#/components/schemas/Lifecycle"
          },
          "url": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "id",
          "status",
          "created",
          "updated",
          "owner",
          "config",
          "fingerprint",
          "salt",
          "attempts",
          "transactions"
        ],
        "additionalProperties": false
      },
      "Key": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "key": {
            "type": "string",
            "description": "Returned only on issuance; never retrieved again."
          },
          "label": {
            "type": "string"
          },
          "scopes": {
            "type": "array",
            "items": {
              "enum": [
                "read",
                "prepare",
                "upload"
              ]
            }
          },
          "created_at": {
            "type": "integer"
          },
          "expires_at": {
            "type": [
              "integer",
              "null"
            ]
          },
          "last_used_at": {
            "type": [
              "integer",
              "null"
            ]
          },
          "revoked_at": {
            "type": [
              "integer",
              "null"
            ]
          }
        },
        "required": [
          "id",
          "label",
          "scopes",
          "created_at",
          "expires_at"
        ],
        "additionalProperties": false
      },
      "Capabilities": {
        "type": "object",
        "properties": {
          "chain_id": {
            "type": "integer"
          },
          "factory": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]{40}$"
          },
          "source_commit": {
            "type": "string"
          },
          "deployment": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]*$"
          },
          "schema": {
            "const": "gama-launch/1"
          },
          "server_time": {
            "type": "integer"
          },
          "preparation_available": {
            "type": "boolean"
          },
          "authentication": {
            "const": "X-Gama-Key"
          },
          "signing": {
            "const": "caller-wallet"
          },
          "modes": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "opening_lock": {
            "type": "boolean"
          },
          "defaults": {
            "type": "object",
            "additionalProperties": {
              "type": [
                "string",
                "number",
                "boolean"
              ]
            }
          },
          "limits": {
            "type": "object",
            "additionalProperties": {
              "type": "number"
            }
          },
          "quote_assets": {
            "type": "string"
          },
          "documentation": {
            "type": "string"
          },
          "openapi": {
            "type": "string"
          },
          "agent_guide": {
            "type": "string"
          },
          "client_manifest": {
            "type": "string"
          },
          "capabilities": {
            "type": "object",
            "properties": {
              "lifecycle": {
                "type": "integer",
                "minimum": 0
              },
              "usage": {
                "type": "integer",
                "minimum": 0
              },
              "reports": {
                "type": "integer",
                "minimum": 0
              },
              "events": {
                "type": "integer",
                "minimum": 0
              },
              "creator_fees": {
                "type": "integer",
                "minimum": 0
              },
              "social_fees": {
                "type": "integer",
                "minimum": 0
              },
              "sales": {
                "type": "integer",
                "minimum": 0,
                "maximum": 1
              }
            },
            "required": [
              "lifecycle",
              "usage",
              "reports",
              "events",
              "sales"
            ],
            "additionalProperties": false
          },
          "creator_policy": {
            "type": "string"
          },
          "creator_fee_operations": {
            "type": "array",
            "items": {
              "enum": [
                "set_shares",
                "distribute",
                "takeover",
                "execute_takeover",
                "cancel_takeover"
              ]
            }
          },
          "social_fee_operations": {
            "type": "array",
            "items": {
              "enum": [
                "create_vaults",
                "forward",
                "claim",
                "change_wallet"
              ]
            }
          },
          "social_fees": {
            "anyOf": [
              {
                "type": "null"
              },
              {
                "type": "object",
                "properties": {
                  "registry": {
                    "type": "string",
                    "pattern": "^0x[0-9a-fA-F]{40}$"
                  },
                  "providers": {
                    "type": "array",
                    "items": {
                      "enum": [
                        "github",
                        "x"
                      ]
                    }
                  },
                  "resolve": {
                    "type": "string"
                  },
                  "claim": {
                    "type": "string"
                  }
                },
                "required": [
                  "registry",
                  "providers",
                  "resolve",
                  "claim"
                ],
                "additionalProperties": false
              }
            ]
          },
          "sale_operations": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "maxItems": 16,
            "minItems": 0
          },
          "sale_policy": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "chain_id",
          "factory",
          "source_commit",
          "deployment",
          "schema",
          "server_time",
          "preparation_available",
          "authentication",
          "signing",
          "modes",
          "opening_lock",
          "defaults",
          "limits",
          "quote_assets",
          "documentation",
          "openapi",
          "agent_guide",
          "client_manifest",
          "capabilities",
          "sale_operations"
        ],
        "additionalProperties": false
      },
      "Challenge": {
        "type": "object",
        "properties": {
          "chain_id": {
            "type": "integer"
          },
          "factory": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]{40}$"
          },
          "source_commit": {
            "type": "string"
          },
          "deployment": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]*$"
          },
          "id": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "expires_at": {
            "type": "integer"
          },
          "action": {
            "enum": [
              "create",
              "list",
              "revoke",
              "rotate"
            ]
          },
          "options": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "label": {
                "type": "string",
                "maxLength": 64
              },
              "scopes": {
                "type": "array",
                "items": {
                  "enum": [
                    "read",
                    "prepare",
                    "upload"
                  ]
                }
              },
              "expires_at": {
                "type": [
                  "integer",
                  "null"
                ]
              }
            },
            "required": [],
            "additionalProperties": false
          }
        },
        "required": [
          "chain_id",
          "factory",
          "source_commit",
          "deployment",
          "id",
          "message",
          "expires_at",
          "action",
          "options"
        ],
        "additionalProperties": false
      },
      "KeyOptions": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "label": {
            "type": "string",
            "maxLength": 64
          },
          "scopes": {
            "type": "array",
            "items": {
              "enum": [
                "read",
                "prepare",
                "upload"
              ]
            }
          },
          "expires_at": {
            "type": [
              "integer",
              "null"
            ]
          }
        },
        "required": [],
        "additionalProperties": false
      },
      "Prepared": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
          },
          "plan": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Plan"
              },
              {
                "$ref": "#/components/schemas/SaleCreationPlan"
              }
            ]
          },
          "recovery": {
            "$ref": "#/components/schemas/Recovery"
          },
          "lifecycle": {
            "$ref": "#/components/schemas/Lifecycle"
          }
        },
        "required": [
          "id"
        ],
        "additionalProperties": false
      },
      "Image": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string"
          },
          "ipfs": {
            "type": "string"
          }
        },
        "required": [
          "url"
        ]
      },
      "ReportMoney": {
        "type": "object",
        "properties": {
          "eth_wei": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^(0|[1-9][0-9]*)$"
              },
              {
                "type": "null"
              }
            ]
          },
          "usd": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "quality": {
            "enum": [
              "complete",
              "partial",
              "unavailable"
            ]
          }
        },
        "required": [
          "eth_wei",
          "usd",
          "quality"
        ],
        "additionalProperties": false
      },
      "ReportAssetMoney": {
        "type": "object",
        "properties": {
          "atoms": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^(0|[1-9][0-9]*)$"
              },
              {
                "type": "null"
              }
            ]
          },
          "eth_wei": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^(0|[1-9][0-9]*)$"
              },
              {
                "type": "null"
              }
            ]
          },
          "usd": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "quality": {
            "enum": [
              "complete",
              "partial",
              "unavailable"
            ]
          },
          "fraction": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^(0|[1-9][0-9]*)$"
              },
              {
                "type": "null"
              }
            ]
          },
          "fraction_scale": {
            "type": "string",
            "pattern": "^(0|[1-9][0-9]*)$"
          }
        },
        "required": [
          "atoms",
          "eth_wei",
          "usd",
          "quality"
        ],
        "additionalProperties": false
      },
      "ReportRange": {
        "type": "object",
        "properties": {
          "period": {
            "enum": [
              "24h",
              "48h",
              "7d",
              "30d",
              "all",
              "2d-london",
              "custom"
            ]
          },
          "from": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1099511627775
          },
          "to": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1099511627775
          },
          "effective_from": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1099511627775
          },
          "effective_to": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1099511627775
          },
          "timezone": {
            "enum": [
              "UTC",
              "Europe/London"
            ]
          },
          "semantics": {
            "const": "inclusive_from_exclusive_to"
          },
          "complete": {
            "type": "boolean"
          }
        },
        "required": [
          "period",
          "from",
          "to",
          "effective_from",
          "effective_to",
          "timezone",
          "semantics",
          "complete"
        ],
        "additionalProperties": false
      },
      "EarningsReport": {
        "type": "object",
        "properties": {
          "schema": {
            "const": "gama-earnings/1"
          },
          "wallet": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]{40}$"
          },
          "category": {
            "enum": [
              "creator",
              "protocol",
              "rewards"
            ]
          },
          "as_of": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1099511627775
          },
          "range": {
            "$ref": "#/components/schemas/ReportRange"
          },
          "coverage": {
            "type": "object",
            "properties": {
              "since": {
                "type": "integer",
                "minimum": 0,
                "maximum": 1099511627775
              },
              "through": {
                "type": "integer",
                "minimum": 0,
                "maximum": 1099511627775
              },
              "source_complete": {
                "type": "boolean"
              },
              "conversion_complete": {
                "type": "boolean"
              }
            },
            "required": [
              "since",
              "through",
              "source_complete",
              "conversion_complete"
            ],
            "additionalProperties": false
          },
          "totals": {
            "type": "object",
            "properties": {
              "earned_gross": {
                "$ref": "#/components/schemas/ReportMoney"
              },
              "paid_net": {
                "$ref": "#/components/schemas/ReportMoney"
              },
              "operating_charges": {
                "$ref": "#/components/schemas/ReportMoney"
              },
              "claimed_gross": {
                "$ref": "#/components/schemas/ReportMoney"
              },
              "automatic_paid_net": {
                "$ref": "#/components/schemas/ReportMoney"
              }
            },
            "required": [
              "earned_gross",
              "paid_net",
              "operating_charges",
              "claimed_gross",
              "automatic_paid_net"
            ],
            "additionalProperties": false
          },
          "attribution": {
            "type": "object",
            "properties": {
              "credits": {
                "const": "recipient_at_accrual"
              },
              "mixed_payments": {
                "const": "creator_proportion_floor_protocol_remainder"
              },
              "tokens": {
                "const": "proportional_largest_remainder"
              },
              "unknown_token": {
                "const": "unallocated"
              },
              "payments_can_spend_prior_earnings": {
                "const": true
              },
              "holder_income": {
                "const": "fractional_entitlement_at_fee_block"
              },
              "creator_sharing": {
                "const": "cumulative_canonical_fee_floors_at_accrual"
              },
              "sharing_claimable": {
                "const": "distributed_plus_virtual_unpaid_proportional_credit"
              },
              "sharing_gifts": {
                "const": "unallocated_not_income"
              },
              "social": {
                "const": "identity_at_accrual_wallet_at_payment"
              }
            },
            "required": [
              "credits",
              "mixed_payments",
              "tokens",
              "unknown_token",
              "payments_can_spend_prior_earnings"
            ],
            "additionalProperties": false
          },
          "unavailable_tokens": {
            "type": "array",
            "maxItems": 4096,
            "items": {
              "type": "string",
              "pattern": "^0x[0-9a-fA-F]{40}$"
            }
          },
          "assets": {
            "type": "array",
            "maxItems": 100,
            "items": {
              "type": "object",
              "properties": {
                "asset": {
                  "type": "string",
                  "pattern": "^0x[0-9a-fA-F]{40}$"
                },
                "decimals": {
                  "anyOf": [
                    {
                      "type": "integer"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "earned_gross": {
                  "$ref": "#/components/schemas/ReportAssetMoney"
                },
                "paid_net": {
                  "$ref": "#/components/schemas/ReportAssetMoney"
                },
                "operating_charges": {
                  "$ref": "#/components/schemas/ReportAssetMoney"
                },
                "claimed_gross": {
                  "$ref": "#/components/schemas/ReportAssetMoney"
                },
                "automatic_paid_net": {
                  "$ref": "#/components/schemas/ReportAssetMoney"
                },
                "claimable": {
                  "type": "object",
                  "properties": {
                    "atoms": {
                      "anyOf": [
                        {
                          "type": "string",
                          "pattern": "^(0|[1-9][0-9]*)$"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "eth_wei": {
                      "anyOf": [
                        {
                          "type": "string",
                          "pattern": "^(0|[1-9][0-9]*)$"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "usd": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "quality": {
                      "enum": [
                        "complete",
                        "partial",
                        "unavailable"
                      ]
                    },
                    "as_of": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 1099511627775
                    },
                    "valuation": {
                      "const": "snapshot"
                    }
                  },
                  "required": [
                    "atoms",
                    "eth_wei",
                    "usd",
                    "quality",
                    "as_of",
                    "valuation"
                  ],
                  "additionalProperties": false
                },
                "unallocated_claimable": {
                  "type": "object",
                  "properties": {
                    "atoms": {
                      "anyOf": [
                        {
                          "type": "string",
                          "pattern": "^(0|[1-9][0-9]*)$"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "eth_wei": {
                      "anyOf": [
                        {
                          "type": "string",
                          "pattern": "^(0|[1-9][0-9]*)$"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "usd": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "quality": {
                      "enum": [
                        "complete",
                        "partial",
                        "unavailable"
                      ]
                    },
                    "as_of": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 1099511627775
                    },
                    "valuation": {
                      "const": "snapshot"
                    }
                  },
                  "required": [
                    "atoms",
                    "eth_wei",
                    "usd",
                    "quality",
                    "as_of",
                    "valuation"
                  ],
                  "additionalProperties": false
                }
              },
              "required": [
                "asset",
                "decimals",
                "earned_gross",
                "paid_net",
                "operating_charges",
                "claimed_gross",
                "automatic_paid_net",
                "claimable"
              ],
              "additionalProperties": false
            }
          },
          "tokens": {
            "type": "array",
            "maxItems": 100,
            "items": {
              "type": "object",
              "properties": {
                "token": {
                  "anyOf": [
                    {
                      "type": "string",
                      "pattern": "^0x[0-9a-fA-F]{40}$"
                    },
                    {
                      "const": "unallocated"
                    }
                  ]
                },
                "earned_gross": {
                  "$ref": "#/components/schemas/ReportMoney"
                },
                "paid_net": {
                  "$ref": "#/components/schemas/ReportMoney"
                },
                "operating_charges": {
                  "$ref": "#/components/schemas/ReportMoney"
                },
                "claimed_gross": {
                  "$ref": "#/components/schemas/ReportMoney"
                },
                "automatic_paid_net": {
                  "$ref": "#/components/schemas/ReportMoney"
                }
              },
              "required": [
                "token",
                "earned_gross",
                "paid_net",
                "operating_charges",
                "claimed_gross",
                "automatic_paid_net"
              ],
              "additionalProperties": false
            }
          },
          "details_complete": {
            "type": "boolean"
          }
        },
        "required": [
          "schema",
          "wallet",
          "category",
          "as_of",
          "range",
          "coverage",
          "totals",
          "attribution",
          "details_complete"
        ],
        "additionalProperties": false
      },
      "TokenReport": {
        "type": "object",
        "properties": {
          "schema": {
            "const": "gama-token-report/1"
          },
          "token": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]{40}$"
          },
          "name": {
            "type": "string"
          },
          "symbol": {
            "type": "string"
          },
          "as_of": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1099511627775
          },
          "range": {
            "$ref": "#/components/schemas/ReportRange"
          },
          "holders": {
            "type": "string",
            "pattern": "^(0|[1-9][0-9]*)$"
          },
          "totals": {
            "type": "object",
            "properties": {
              "volume": {
                "$ref": "#/components/schemas/ReportMoney"
              },
              "trades": {
                "type": "string",
                "pattern": "^(0|[1-9][0-9]*)$"
              },
              "creator_fees": {
                "$ref": "#/components/schemas/ReportMoney"
              },
              "protocol_fees": {
                "$ref": "#/components/schemas/ReportMoney"
              },
              "holder_rewards": {
                "$ref": "#/components/schemas/ReportMoney"
              }
            },
            "required": [
              "volume",
              "trades",
              "creator_fees",
              "protocol_fees",
              "holder_rewards"
            ],
            "additionalProperties": false
          },
          "coverage": {
            "type": "object",
            "properties": {
              "since": {
                "type": "integer",
                "minimum": 0,
                "maximum": 1099511627775
              },
              "through": {
                "type": "integer",
                "minimum": 0,
                "maximum": 1099511627775
              },
              "source_complete": {
                "type": "boolean"
              }
            },
            "required": [
              "since",
              "through",
              "source_complete"
            ],
            "additionalProperties": false
          },
          "trade_definition": {
            "const": "one_transaction_owner_per_participating_token"
          },
          "links": {
            "type": "object",
            "properties": {
              "page": {
                "type": "string"
              },
              "detail": {
                "type": "string"
              }
            },
            "required": [
              "page",
              "detail"
            ],
            "additionalProperties": false
          },
          "launch": {
            "type": "object",
            "properties": {
              "phase": {
                "type": "string"
              },
              "curve": {
                "anyOf": [
                  {
                    "type": "object"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "graduation": {
                "anyOf": [
                  {
                    "type": "object"
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "required": [
              "phase",
              "curve",
              "graduation"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "schema",
          "token",
          "name",
          "symbol",
          "as_of",
          "range",
          "holders",
          "totals",
          "coverage",
          "trade_definition",
          "links",
          "launch"
        ],
        "additionalProperties": false
      },
      "EarningsResponse": {
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/EarningsReport"
          },
          "head": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1099511627775
          },
          "block_hash": {
            "type": "string"
          },
          "head_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "reorg_count": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1099511627775
          },
          "chain_id": {
            "type": "integer"
          },
          "stale": {
            "type": "boolean"
          },
          "next_cursor": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "cursor_expires_at": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1099511627775
          }
        },
        "required": [
          "data",
          "head",
          "block_hash",
          "reorg_count",
          "chain_id",
          "stale"
        ]
      },
      "TokenReportResponse": {
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/TokenReport"
          },
          "head": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1099511627775
          },
          "block_hash": {
            "type": "string"
          },
          "head_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "reorg_count": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1099511627775
          },
          "chain_id": {
            "type": "integer"
          },
          "stale": {
            "type": "boolean"
          },
          "next_cursor": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "cursor_expires_at": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1099511627775
          }
        },
        "required": [
          "data",
          "head",
          "block_hash",
          "reorg_count",
          "chain_id",
          "stale"
        ]
      },
      "Notification": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "type": {
            "enum": [
              "intent.changed",
              "launch.indexed",
              "launch.finalized",
              "token.graduated",
              "credit.paid",
              "credit.claimed",
              "rewards.paid",
              "rewards.claimed"
            ]
          },
          "at": {
            "type": "integer",
            "minimum": 0
          },
          "observation": {
            "enum": [
              "service",
              "indexed",
              "finalized"
            ]
          },
          "intent_id": {
            "type": "string"
          },
          "chain_id": {
            "type": "integer",
            "minimum": 0
          },
          "release": {
            "type": "string"
          },
          "block": {
            "type": "integer",
            "minimum": 0
          },
          "block_hash": {
            "type": "string"
          },
          "transaction": {
            "type": "string"
          },
          "wallet": {
            "type": "string"
          },
          "token": {
            "type": "string"
          },
          "reorg_count": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": 0
              },
              {
                "type": "null"
              }
            ]
          },
          "data": {
            "type": "object",
            "additionalProperties": true
          }
        },
        "required": [
          "id",
          "type",
          "at",
          "observation",
          "data"
        ],
        "additionalProperties": false
      },
      "Updates": {
        "type": "object",
        "properties": {
          "schema": {
            "const": "gama-events/1"
          },
          "events": {
            "type": "array",
            "maxItems": 100,
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "type": {
                  "enum": [
                    "intent.changed",
                    "launch.indexed",
                    "launch.finalized",
                    "token.graduated",
                    "credit.paid",
                    "credit.claimed",
                    "rewards.paid",
                    "rewards.claimed"
                  ]
                },
                "at": {
                  "type": "integer",
                  "minimum": 0
                },
                "observation": {
                  "enum": [
                    "service",
                    "indexed",
                    "finalized"
                  ]
                },
                "intent_id": {
                  "type": "string"
                },
                "chain_id": {
                  "type": "integer",
                  "minimum": 0
                },
                "release": {
                  "type": "string"
                },
                "block": {
                  "type": "integer",
                  "minimum": 0
                },
                "block_hash": {
                  "type": "string"
                },
                "transaction": {
                  "type": "string"
                },
                "wallet": {
                  "type": "string"
                },
                "token": {
                  "type": "string"
                },
                "reorg_count": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": 0
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "data": {
                  "type": "object",
                  "additionalProperties": true
                }
              },
              "required": [
                "id",
                "type",
                "at",
                "observation",
                "data"
              ],
              "additionalProperties": false
            }
          },
          "cursor": {
            "type": "string"
          },
          "more": {
            "type": "boolean"
          },
          "head": {
            "type": "integer",
            "minimum": 0
          },
          "head_hash": {
            "type": "string"
          },
          "head_at": {
            "type": "integer",
            "minimum": 0
          },
          "reorg_count": {
            "type": "integer",
            "minimum": 0
          },
          "finalized": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "block": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "hash": {
                    "type": "string"
                  }
                },
                "required": [
                  "block",
                  "hash"
                ],
                "additionalProperties": false
              },
              {
                "type": "null"
              }
            ]
          },
          "coverage": {
            "type": "object",
            "properties": {
              "retained_seconds": {
                "type": "integer",
                "minimum": 0
              },
              "cursor_required_for_replay": {
                "const": true
              },
              "bounded_by_capacity": {
                "const": true
              }
            },
            "required": [
              "retained_seconds",
              "cursor_required_for_replay",
              "bounded_by_capacity"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "schema",
          "events",
          "cursor",
          "more",
          "head",
          "head_hash",
          "head_at",
          "reorg_count",
          "finalized",
          "coverage"
        ],
        "additionalProperties": false
      },
      "CreatorShares": {
        "type": "array",
        "minItems": 1,
        "maxItems": 32,
        "items": {
          "type": "object",
          "properties": {
            "address": {
              "type": "string",
              "pattern": "^0x[0-9a-fA-F]{40}$"
            },
            "bps": {
              "type": "integer",
              "minimum": 1,
              "maximum": 10000
            },
            "social": {
              "type": "object",
              "properties": {
                "provider": {
                  "enum": [
                    1,
                    2
                  ]
                },
                "subject": {
                  "type": "string",
                  "pattern": "^[1-9][0-9]{0,19}$",
                  "description": "Stable nonzero uint64 account ID. Never a handle."
                }
              },
              "required": [
                "provider",
                "subject"
              ],
              "additionalProperties": false
            }
          },
          "required": [
            "address",
            "bps"
          ],
          "additionalProperties": false
        },
        "description": "Exact whole basis points totaling 10,000. The current creator policy may impose a smaller recipient count."
      },
      "CreatorFeeTerms": {
        "type": "object",
        "properties": {
          "curveFeeBps": {
            "type": "integer",
            "minimum": 0,
            "maximum": 10000
          },
          "poolFeeBps": {
            "type": "integer",
            "minimum": 0,
            "maximum": 10000
          },
          "creatorTaxBps": {
            "type": "integer",
            "minimum": 0,
            "maximum": 10000
          },
          "holderFeeBps": {
            "type": "integer",
            "minimum": 0,
            "maximum": 10000
          },
          "protocolShareBps": {
            "type": "integer",
            "minimum": 0,
            "maximum": 10000
          },
          "rewardMode": {
            "type": "boolean"
          }
        },
        "required": [
          "curveFeeBps",
          "poolFeeBps",
          "creatorTaxBps",
          "holderFeeBps",
          "protocolShareBps",
          "rewardMode"
        ],
        "additionalProperties": false
      },
      "CreatorAction": {
        "type": "object",
        "properties": {
          "operation": {
            "enum": [
              "set_shares",
              "distribute",
              "takeover",
              "execute_takeover",
              "cancel_takeover"
            ],
            "description": "Choose an advertised creator_fee_operations entry. Versions 2 and 3 support set_shares, distribute and direct takeover; execute_takeover and cancel_takeover belong only to version 1 deployments."
          },
          "wallet": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]{40}$"
          },
          "token": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]{40}$"
          },
          "shares": {
            "$ref": "#/components/schemas/CreatorShares"
          },
          "account": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]{40}$"
          },
          "custody": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]{40}$"
          },
          "new_admin": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]{40}$"
          },
          "terms": {
            "$ref": "#/components/schemas/CreatorFeeTerms"
          }
        },
        "required": [
          "operation",
          "wallet",
          "token"
        ],
        "additionalProperties": false
      },
      "CreatorPlan": {
        "type": "object",
        "properties": {
          "schema": {
            "const": "gama-creator-fees/1"
          },
          "chain_id": {
            "type": "integer"
          },
          "factory": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]{40}$"
          },
          "source_commit": {
            "type": "string"
          },
          "input": {
            "$ref": "#/components/schemas/CreatorAction"
          },
          "plan_id": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]{64}$"
          },
          "prepared_at": {
            "type": "integer"
          },
          "expires_at": {
            "type": "integer"
          },
          "review_block": {
            "type": "string",
            "pattern": "^(0|[1-9][0-9]{0,77})$"
          },
          "review_block_hash": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]{64}$"
          },
          "state": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "admin": {
                    "type": "string",
                    "pattern": "^0x[0-9a-fA-F]{40}$"
                  },
                  "epoch": {
                    "type": "string",
                    "pattern": "^(0|[1-9][0-9]{0,77})$"
                  },
                  "locked": {
                    "type": "boolean"
                  },
                  "terms": {
                    "type": "object",
                    "properties": {
                      "curveFeeBps": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 10000
                      },
                      "poolFeeBps": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 10000
                      },
                      "creatorTaxBps": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 10000
                      },
                      "holderFeeBps": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 10000
                      },
                      "protocolShareBps": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 10000
                      },
                      "rewardMode": {
                        "type": "boolean"
                      },
                      "version": {
                        "type": "string",
                        "pattern": "^(0|[1-9][0-9]{0,77})$"
                      }
                    },
                    "required": [
                      "curveFeeBps",
                      "poolFeeBps",
                      "creatorTaxBps",
                      "holderFeeBps",
                      "protocolShareBps",
                      "rewardMode",
                      "version"
                    ],
                    "additionalProperties": false
                  },
                  "owner": {
                    "type": "string",
                    "pattern": "^0x[0-9a-fA-F]{40}$"
                  },
                  "policy_version": {
                    "type": "string",
                    "pattern": "^(0|[1-9][0-9]{0,77})$"
                  },
                  "max_recipients": {
                    "type": "integer"
                  },
                  "asset": {
                    "type": "string",
                    "pattern": "^0x[0-9a-fA-F]{40}$"
                  },
                  "takeover_commitment": {
                    "type": "string",
                    "pattern": "^0x[0-9a-fA-F]{64}$"
                  },
                  "contract_version": {
                    "const": 2
                  }
                },
                "required": [
                  "admin",
                  "epoch",
                  "locked",
                  "terms",
                  "owner",
                  "policy_version",
                  "max_recipients",
                  "asset",
                  "takeover_commitment",
                  "contract_version"
                ],
                "additionalProperties": false
              },
              {
                "type": "object",
                "properties": {
                  "admin": {
                    "type": "string",
                    "pattern": "^0x[0-9a-fA-F]{40}$"
                  },
                  "epoch": {
                    "type": "string",
                    "pattern": "^(0|[1-9][0-9]{0,77})$"
                  },
                  "locked": {
                    "type": "boolean"
                  },
                  "terms": {
                    "type": "object",
                    "properties": {
                      "curveFeeBps": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 10000
                      },
                      "poolFeeBps": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 10000
                      },
                      "creatorTaxBps": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 10000
                      },
                      "holderFeeBps": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 10000
                      },
                      "protocolShareBps": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 10000
                      },
                      "rewardMode": {
                        "type": "boolean"
                      },
                      "version": {
                        "type": "string",
                        "pattern": "^(0|[1-9][0-9]{0,77})$"
                      }
                    },
                    "required": [
                      "curveFeeBps",
                      "poolFeeBps",
                      "creatorTaxBps",
                      "holderFeeBps",
                      "protocolShareBps",
                      "rewardMode",
                      "version"
                    ],
                    "additionalProperties": false
                  },
                  "owner": {
                    "type": "string",
                    "pattern": "^0x[0-9a-fA-F]{40}$"
                  },
                  "policy_version": {
                    "type": "string",
                    "pattern": "^(0|[1-9][0-9]{0,77})$"
                  },
                  "max_recipients": {
                    "type": "integer"
                  },
                  "asset": {
                    "type": "string",
                    "pattern": "^0x[0-9a-fA-F]{40}$"
                  },
                  "takeover_commitment": {
                    "type": "string",
                    "pattern": "^0x[0-9a-fA-F]{64}$"
                  },
                  "contract_version": {
                    "const": 3
                  },
                  "shares_commitment": {
                    "type": "string",
                    "pattern": "^0x[0-9a-fA-F]{64}$"
                  }
                },
                "required": [
                  "admin",
                  "epoch",
                  "locked",
                  "terms",
                  "owner",
                  "policy_version",
                  "max_recipients",
                  "asset",
                  "takeover_commitment",
                  "contract_version"
                ],
                "additionalProperties": false
              },
              {
                "type": "object",
                "properties": {
                  "admin": {
                    "type": "string",
                    "pattern": "^0x[0-9a-fA-F]{40}$"
                  },
                  "epoch": {
                    "type": "string",
                    "pattern": "^(0|[1-9][0-9]{0,77})$"
                  },
                  "locked": {
                    "type": "boolean"
                  },
                  "terms": {
                    "type": "object",
                    "properties": {
                      "curveFeeBps": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 10000
                      },
                      "poolFeeBps": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 10000
                      },
                      "creatorTaxBps": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 10000
                      },
                      "holderFeeBps": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 10000
                      },
                      "protocolShareBps": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 10000
                      },
                      "rewardMode": {
                        "type": "boolean"
                      },
                      "version": {
                        "type": "string",
                        "pattern": "^(0|[1-9][0-9]{0,77})$"
                      }
                    },
                    "required": [
                      "curveFeeBps",
                      "poolFeeBps",
                      "creatorTaxBps",
                      "holderFeeBps",
                      "protocolShareBps",
                      "rewardMode",
                      "version"
                    ],
                    "additionalProperties": false
                  },
                  "owner": {
                    "type": "string",
                    "pattern": "^0x[0-9a-fA-F]{40}$"
                  },
                  "policy_version": {
                    "type": "string",
                    "pattern": "^(0|[1-9][0-9]{0,77})$"
                  },
                  "max_recipients": {
                    "type": "integer"
                  },
                  "asset": {
                    "type": "string",
                    "pattern": "^0x[0-9a-fA-F]{40}$"
                  },
                  "takeover_commitment": {
                    "type": "string",
                    "pattern": "^0x[0-9a-fA-F]{64}$"
                  },
                  "notice_seconds": {
                    "type": "integer"
                  },
                  "window_seconds": {
                    "type": "integer"
                  },
                  "replacement_commitment": {
                    "type": "string",
                    "pattern": "^0x[0-9a-fA-F]{64}$"
                  },
                  "pending": {
                    "anyOf": [
                      {
                        "type": "null"
                      },
                      {
                        "type": "object",
                        "properties": {
                          "admin": {
                            "type": "string",
                            "pattern": "^0x[0-9a-fA-F]{40}$"
                          },
                          "effective_at": {
                            "type": "string",
                            "pattern": "^(0|[1-9][0-9]{0,77})$"
                          },
                          "expires_at": {
                            "type": "string",
                            "pattern": "^(0|[1-9][0-9]{0,77})$"
                          },
                          "terms": {
                            "anyOf": [
                              {
                                "type": "null"
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "curveFeeBps": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 10000
                                  },
                                  "poolFeeBps": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 10000
                                  },
                                  "creatorTaxBps": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 10000
                                  },
                                  "holderFeeBps": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 10000
                                  },
                                  "protocolShareBps": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 10000
                                  },
                                  "rewardMode": {
                                    "type": "boolean"
                                  },
                                  "version": {
                                    "type": "string",
                                    "pattern": "^(0|[1-9][0-9]{0,77})$"
                                  }
                                },
                                "required": [
                                  "curveFeeBps",
                                  "poolFeeBps",
                                  "creatorTaxBps",
                                  "holderFeeBps",
                                  "protocolShareBps",
                                  "rewardMode",
                                  "version"
                                ],
                                "additionalProperties": false
                              }
                            ]
                          }
                        },
                        "required": [
                          "admin",
                          "effective_at",
                          "expires_at",
                          "terms"
                        ],
                        "additionalProperties": false
                      }
                    ]
                  }
                },
                "required": [
                  "admin",
                  "epoch",
                  "locked",
                  "terms",
                  "owner",
                  "policy_version",
                  "max_recipients",
                  "asset",
                  "takeover_commitment",
                  "notice_seconds",
                  "window_seconds",
                  "replacement_commitment",
                  "pending"
                ],
                "additionalProperties": false
              }
            ]
          },
          "transaction": {
            "$ref": "#/components/schemas/UnsignedTransaction"
          },
          "simulation": {
            "type": "object",
            "properties": {
              "state": {
                "enum": [
                  "passed",
                  "wallet_execution_required"
                ]
              },
              "gas": {
                "type": "string",
                "pattern": "^(0|[1-9][0-9]{0,77})$"
              }
            },
            "required": [
              "state",
              "gas"
            ],
            "additionalProperties": false
          },
          "effect": {
            "type": "string"
          }
        },
        "required": [
          "schema",
          "chain_id",
          "factory",
          "source_commit",
          "input",
          "plan_id",
          "prepared_at",
          "expires_at",
          "review_block",
          "review_block_hash",
          "state",
          "transaction",
          "simulation",
          "effect"
        ],
        "additionalProperties": false
      },
      "CreatorPrepared": {
        "type": "object",
        "properties": {
          "plan": {
            "$ref": "#/components/schemas/CreatorPlan"
          }
        },
        "required": [
          "plan"
        ],
        "additionalProperties": false
      },
      "SocialIdentity": {
        "type": "object",
        "properties": {
          "provider": {
            "enum": [
              1,
              2
            ]
          },
          "subject": {
            "type": "string",
            "pattern": "^[1-9][0-9]{0,19}$",
            "description": "Stable nonzero uint64 account ID. Never a handle."
          },
          "vault": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]{40}$"
          }
        },
        "required": [
          "provider",
          "subject",
          "vault"
        ],
        "additionalProperties": false
      },
      "SocialBinding": {
        "type": "object",
        "properties": {
          "provider": {
            "enum": [
              1,
              2
            ]
          },
          "subject": {
            "type": "string",
            "pattern": "^[1-9][0-9]{0,19}$",
            "description": "Stable nonzero uint64 account ID. Never a handle."
          },
          "vault": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]{40}$"
          },
          "registry": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]{40}$"
          },
          "wallet": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]{40}$"
          },
          "nonce": {
            "type": "string",
            "pattern": "^(0|[1-9][0-9]{0,77})$"
          },
          "policy": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]{40}$"
          },
          "escrow": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]{40}$"
          }
        },
        "required": [
          "provider",
          "subject",
          "vault",
          "registry",
          "wallet",
          "nonce",
          "policy",
          "escrow"
        ],
        "additionalProperties": false
      },
      "SocialBindingResponse": {
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/SocialBinding"
          },
          "head": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1099511627775
          },
          "block_hash": {
            "type": "string"
          },
          "head_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "reorg_count": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1099511627775
          },
          "chain_id": {
            "type": "integer"
          },
          "stale": {
            "type": "boolean"
          },
          "next_cursor": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "cursor_expires_at": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1099511627775
          }
        },
        "required": [
          "data",
          "head",
          "block_hash",
          "reorg_count",
          "chain_id",
          "stale"
        ]
      },
      "SocialAllocations": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "vault": {
                  "type": "string",
                  "pattern": "^0x[0-9a-fA-F]{40}$"
                },
                "account": {
                  "type": "string",
                  "pattern": "^0x[0-9a-fA-F]{40}$"
                },
                "token": {
                  "type": "string",
                  "pattern": "^0x[0-9a-fA-F]{40}$"
                },
                "bps": {
                  "type": "integer"
                },
                "epoch": {
                  "type": "string",
                  "pattern": "^(0|[1-9][0-9]{0,77})$"
                },
                "registry": {
                  "type": "string",
                  "pattern": "^0x[0-9a-fA-F]{40}$"
                },
                "position": {
                  "type": "string",
                  "pattern": "^0x[0-9a-fA-F]{40}$"
                }
              },
              "required": [
                "vault",
                "account",
                "token",
                "bps",
                "epoch",
                "registry",
                "position"
              ],
              "additionalProperties": false
            }
          },
          "head": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1099511627775
          },
          "block_hash": {
            "type": "string"
          },
          "head_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "reorg_count": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1099511627775
          },
          "chain_id": {
            "type": "integer"
          },
          "stale": {
            "type": "boolean"
          },
          "next_cursor": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "cursor_expires_at": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1099511627775
          }
        },
        "required": [
          "data",
          "head",
          "block_hash",
          "reorg_count",
          "chain_id",
          "stale"
        ]
      },
      "SocialCredits": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "provider": {
                  "enum": [
                    1,
                    2
                  ]
                },
                "subject": {
                  "type": "string",
                  "pattern": "^[1-9][0-9]{0,19}$",
                  "description": "Stable nonzero uint64 account ID. Never a handle."
                },
                "vault": {
                  "type": "string",
                  "pattern": "^0x[0-9a-fA-F]{40}$"
                },
                "registry": {
                  "type": "string",
                  "pattern": "^0x[0-9a-fA-F]{40}$"
                },
                "wallet": {
                  "type": "string",
                  "pattern": "^0x[0-9a-fA-F]{40}$"
                },
                "nonce": {
                  "type": "string",
                  "pattern": "^(0|[1-9][0-9]{0,77})$"
                },
                "policy": {
                  "type": "string",
                  "pattern": "^0x[0-9a-fA-F]{40}$"
                },
                "escrow": {
                  "type": "string",
                  "pattern": "^0x[0-9a-fA-F]{40}$"
                },
                "custody": {
                  "type": "string",
                  "pattern": "^0x[0-9a-fA-F]{40}$"
                },
                "asset": {
                  "type": "string",
                  "pattern": "^0x[0-9a-fA-F]{40}$"
                },
                "whole": {
                  "type": "string",
                  "pattern": "^(0|[1-9][0-9]{0,77})$"
                },
                "forwarded": {
                  "type": "string",
                  "pattern": "^(0|[1-9][0-9]{0,77})$"
                },
                "claimed": {
                  "type": "string",
                  "pattern": "^(0|[1-9][0-9]{0,77})$"
                },
                "position": {
                  "type": "string"
                }
              },
              "required": [
                "provider",
                "subject",
                "vault",
                "registry",
                "wallet",
                "nonce",
                "policy",
                "escrow",
                "custody",
                "asset",
                "whole",
                "forwarded",
                "claimed",
                "position"
              ],
              "additionalProperties": false
            }
          },
          "head": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1099511627775
          },
          "block_hash": {
            "type": "string"
          },
          "head_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "reorg_count": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1099511627775
          },
          "chain_id": {
            "type": "integer"
          },
          "stale": {
            "type": "boolean"
          },
          "next_cursor": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "cursor_expires_at": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1099511627775
          }
        },
        "required": [
          "data",
          "head",
          "block_hash",
          "reorg_count",
          "chain_id",
          "stale"
        ]
      },
      "SocialIdentities": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "provider": {
                  "enum": [
                    1,
                    2
                  ]
                },
                "subject": {
                  "type": "string",
                  "pattern": "^[1-9][0-9]{0,19}$",
                  "description": "Stable nonzero uint64 account ID. Never a handle."
                },
                "vault": {
                  "type": "string",
                  "pattern": "^0x[0-9a-fA-F]{40}$"
                },
                "registry": {
                  "type": "string",
                  "pattern": "^0x[0-9a-fA-F]{40}$"
                },
                "wallet": {
                  "type": "string",
                  "pattern": "^0x[0-9a-fA-F]{40}$"
                },
                "nonce": {
                  "type": "string",
                  "pattern": "^(0|[1-9][0-9]{0,77})$"
                },
                "policy": {
                  "type": "string",
                  "pattern": "^0x[0-9a-fA-F]{40}$"
                },
                "escrow": {
                  "type": "string",
                  "pattern": "^0x[0-9a-fA-F]{40}$"
                },
                "position": {
                  "type": "string",
                  "pattern": "^0x[0-9a-fA-F]{40}$"
                }
              },
              "required": [
                "provider",
                "subject",
                "vault",
                "registry",
                "wallet",
                "nonce",
                "policy",
                "escrow",
                "position"
              ],
              "additionalProperties": false
            }
          },
          "head": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1099511627775
          },
          "block_hash": {
            "type": "string"
          },
          "head_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "reorg_count": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1099511627775
          },
          "chain_id": {
            "type": "integer"
          },
          "stale": {
            "type": "boolean"
          },
          "next_cursor": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "cursor_expires_at": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1099511627775
          }
        },
        "required": [
          "data",
          "head",
          "block_hash",
          "reorg_count",
          "chain_id",
          "stale"
        ]
      },
      "SocialResolution": {
        "type": "object",
        "properties": {
          "provider": {
            "enum": [
              "github",
              "x"
            ]
          },
          "subject": {
            "type": "string",
            "pattern": "^[1-9][0-9]{0,19}$",
            "description": "Stable nonzero uint64 account ID. Never a handle."
          },
          "kind": {
            "enum": [
              "user",
              "organization"
            ]
          },
          "handle": {
            "type": "string"
          },
          "display_name": {
            "type": "string"
          },
          "profile_url": {
            "type": "string"
          },
          "vault": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]{40}$"
          },
          "deployed": {
            "type": "boolean"
          },
          "wallet": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^0x[0-9a-fA-F]{40}$"
              },
              {
                "type": "null"
              }
            ]
          },
          "as_of": {
            "type": "integer"
          }
        },
        "required": [
          "provider",
          "subject",
          "kind",
          "handle",
          "display_name",
          "profile_url",
          "vault",
          "deployed",
          "wallet",
          "as_of"
        ],
        "additionalProperties": false
      },
      "SocialAction": {
        "type": "object",
        "properties": {
          "operation": {
            "enum": [
              "create_vaults",
              "forward",
              "claim",
              "change_wallet"
            ]
          },
          "wallet": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]{40}$"
          },
          "identities": {
            "type": "array",
            "minItems": 1,
            "maxItems": 32,
            "items": {
              "$ref": "#/components/schemas/SocialIdentity"
            }
          },
          "identity": {
            "$ref": "#/components/schemas/SocialIdentity"
          },
          "custody": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]{40}$"
          },
          "asset": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]{40}$"
          },
          "amount": {
            "type": "string",
            "pattern": "^(0|[1-9][0-9]{0,77})$"
          },
          "wrap_native": {
            "type": "boolean"
          },
          "next_wallet": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]{40}$"
          }
        },
        "required": [
          "operation",
          "wallet"
        ],
        "additionalProperties": false
      },
      "SocialPlan": {
        "type": "object",
        "properties": {
          "schema": {
            "const": "gama-social-fees/1"
          },
          "chain_id": {
            "type": "integer"
          },
          "factory": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]{40}$"
          },
          "source_commit": {
            "type": "string"
          },
          "input": {
            "$ref": "#/components/schemas/SocialAction"
          },
          "plan_id": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]{64}$"
          },
          "prepared_at": {
            "type": "integer"
          },
          "expires_at": {
            "type": "integer"
          },
          "review_block": {
            "type": "string",
            "pattern": "^(0|[1-9][0-9]{0,77})$"
          },
          "review_block_hash": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]{64}$"
          },
          "state": {
            "type": "object",
            "properties": {
              "registry": {
                "type": "string",
                "pattern": "^0x[0-9a-fA-F]{40}$"
              },
              "identities": {
                "type": "array",
                "maxItems": 32,
                "items": {
                  "type": "object",
                  "properties": {
                    "provider": {
                      "enum": [
                        1,
                        2
                      ]
                    },
                    "subject": {
                      "type": "string",
                      "pattern": "^[1-9][0-9]{0,19}$",
                      "description": "Stable nonzero uint64 account ID. Never a handle."
                    },
                    "vault": {
                      "type": "string",
                      "pattern": "^0x[0-9a-fA-F]{40}$"
                    },
                    "deployed": {
                      "type": "boolean"
                    },
                    "wallet": {
                      "type": "string",
                      "pattern": "^0x[0-9a-fA-F]{40}$"
                    },
                    "nonce": {
                      "type": "string",
                      "pattern": "^(0|[1-9][0-9]{0,77})$"
                    }
                  },
                  "required": [
                    "provider",
                    "subject",
                    "vault"
                  ],
                  "additionalProperties": false
                }
              }
            },
            "required": [
              "registry",
              "identities"
            ],
            "additionalProperties": false
          },
          "transaction": {
            "$ref": "#/components/schemas/UnsignedTransaction"
          },
          "simulation": {
            "type": "object",
            "properties": {
              "state": {
                "enum": [
                  "passed",
                  "wallet_execution_required"
                ]
              },
              "gas": {
                "type": "string",
                "pattern": "^(0|[1-9][0-9]{0,77})$"
              }
            },
            "required": [
              "state",
              "gas"
            ],
            "additionalProperties": false
          },
          "effect": {
            "type": "string"
          }
        },
        "required": [
          "schema",
          "chain_id",
          "factory",
          "source_commit",
          "input",
          "plan_id",
          "prepared_at",
          "expires_at",
          "review_block",
          "review_block_hash",
          "state",
          "transaction",
          "simulation",
          "effect"
        ],
        "additionalProperties": false
      },
      "SocialPrepared": {
        "type": "object",
        "properties": {
          "plan": {
            "$ref": "#/components/schemas/SocialPlan"
          }
        },
        "required": [
          "plan"
        ],
        "additionalProperties": false
      },
      "SaleConfig": {
        "type": "object",
        "properties": {
          "kind": {
            "const": "sale"
          },
          "creator": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]{40}$"
          },
          "request": {
            "type": "object",
            "properties": {
              "metadata": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 64
                  },
                  "symbol": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 16
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 2048
                  },
                  "logo": {
                    "type": "string",
                    "maxLength": 512
                  },
                  "socials": {
                    "type": "object",
                    "properties": {
                      "twitter": {
                        "type": "string",
                        "maxLength": 256
                      },
                      "telegram": {
                        "type": "string",
                        "maxLength": 256
                      },
                      "discord": {
                        "type": "string",
                        "maxLength": 256
                      },
                      "website": {
                        "type": "string",
                        "maxLength": 256
                      },
                      "farcaster": {
                        "type": "string",
                        "maxLength": 256
                      }
                    },
                    "required": [],
                    "additionalProperties": false
                  }
                },
                "required": [
                  "name",
                  "symbol"
                ],
                "additionalProperties": false
              },
              "quote": {
                "type": "string",
                "pattern": "^0x[0-9a-fA-F]{40}$"
              },
              "saleSalt": {
                "type": "string",
                "pattern": "^0x[0-9a-fA-F]{64}$"
              },
              "economics": {
                "type": "object",
                "properties": {
                  "format": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 3
                  },
                  "supply": {
                    "type": "string",
                    "pattern": "^(0|[1-9][0-9]{0,77})$"
                  },
                  "reserves": {
                    "type": "string",
                    "pattern": "^(0|[1-9][0-9]{0,77})$"
                  },
                  "softCap": {
                    "type": "string",
                    "pattern": "^(0|[1-9][0-9]{0,77})$"
                  },
                  "tiers": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "inventory": {
                          "type": "string",
                          "pattern": "^(0|[1-9][0-9]{0,77})$"
                        },
                        "price": {
                          "type": "object",
                          "properties": {
                            "quote": {
                              "type": "string",
                              "pattern": "^(0|[1-9][0-9]{0,77})$"
                            },
                            "tokens": {
                              "type": "string",
                              "pattern": "^(0|[1-9][0-9]{0,77})$"
                            }
                          },
                          "required": [
                            "quote",
                            "tokens"
                          ],
                          "additionalProperties": false
                        },
                        "reservedBps": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 10000
                        },
                        "releaseUnused": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "inventory",
                        "price",
                        "reservedBps",
                        "releaseUnused"
                      ],
                      "additionalProperties": false
                    },
                    "maxItems": 16,
                    "minItems": 1
                  },
                  "rollover": {
                    "type": "boolean"
                  },
                  "opening": {
                    "type": "object",
                    "properties": {
                      "quote": {
                        "type": "string",
                        "pattern": "^(0|[1-9][0-9]{0,77})$"
                      },
                      "tokens": {
                        "type": "string",
                        "pattern": "^(0|[1-9][0-9]{0,77})$"
                      }
                    },
                    "required": [
                      "quote",
                      "tokens"
                    ],
                    "additionalProperties": false
                  },
                  "fairOpeningMultipleBps": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 4294967295
                  },
                  "platformQuoteBps": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 10000
                  },
                  "platformTokenBps": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 10000
                  },
                  "referralBps": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 10000
                  },
                  "liquidityBps": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 10000
                  }
                },
                "required": [
                  "format",
                  "supply",
                  "reserves",
                  "softCap",
                  "tiers",
                  "rollover",
                  "opening",
                  "fairOpeningMultipleBps",
                  "platformQuoteBps",
                  "platformTokenBps",
                  "referralBps",
                  "liquidityBps"
                ],
                "additionalProperties": false
              },
              "rules": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "opensAt": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 1099511627775
                    },
                    "closesAt": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 1099511627775
                    },
                    "access": {
                      "type": "object",
                      "properties": {
                        "kind": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 2
                        },
                        "whitelistRoot": {
                          "type": "string",
                          "pattern": "^0x[0-9a-fA-F]{64}$"
                        },
                        "whitelistContent": {
                          "type": "string",
                          "pattern": "^0x[0-9a-fA-F]{64}$"
                        },
                        "minimum": {
                          "type": "string",
                          "pattern": "^(0|[1-9][0-9]{0,77})$"
                        },
                        "maximum": {
                          "type": "string",
                          "pattern": "^(0|[1-9][0-9]{0,77})$"
                        },
                        "publicAt": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 1099511627775
                        },
                        "gamaMinimum": {
                          "type": "string",
                          "pattern": "^(0|[1-9][0-9]{0,77})$"
                        },
                        "snapshotBlock": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 281474976710655
                        },
                        "earlyUntil": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 1099511627775
                        },
                        "releaseReservedAt": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 1099511627775
                        }
                      },
                      "required": [
                        "kind",
                        "whitelistRoot",
                        "whitelistContent",
                        "minimum",
                        "maximum",
                        "publicAt",
                        "gamaMinimum",
                        "snapshotBlock",
                        "earlyUntil",
                        "releaseReservedAt"
                      ],
                      "additionalProperties": false
                    },
                    "vesting": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "time": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 4294967295
                          },
                          "share": {
                            "type": "string",
                            "pattern": "^(0|[1-9][0-9]{0,77})$"
                          }
                        },
                        "required": [
                          "time",
                          "share"
                        ],
                        "additionalProperties": false
                      },
                      "maxItems": 64,
                      "minItems": 1
                    }
                  },
                  "required": [
                    "opensAt",
                    "closesAt",
                    "access",
                    "vesting"
                  ],
                  "additionalProperties": false
                },
                "maxItems": 16,
                "minItems": 1
              },
              "reserves": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "recipient": {
                      "type": "string",
                      "pattern": "^0x[0-9a-fA-F]{40}$"
                    },
                    "amount": {
                      "type": "string",
                      "pattern": "^(0|[1-9][0-9]{0,77})$"
                    },
                    "label": {
                      "type": "string",
                      "maxLength": 64
                    },
                    "vesting": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "time": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 4294967295
                          },
                          "share": {
                            "type": "string",
                            "pattern": "^(0|[1-9][0-9]{0,77})$"
                          }
                        },
                        "required": [
                          "time",
                          "share"
                        ],
                        "additionalProperties": false
                      },
                      "maxItems": 64,
                      "minItems": 1
                    }
                  },
                  "required": [
                    "recipient",
                    "amount",
                    "label",
                    "vesting"
                  ],
                  "additionalProperties": false
                },
                "maxItems": 32,
                "minItems": 0
              },
              "project": {
                "type": "object",
                "properties": {
                  "recipients": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "account": {
                          "type": "string",
                          "pattern": "^0x[0-9a-fA-F]{40}$"
                        },
                        "shareBps": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 10000
                        }
                      },
                      "required": [
                        "account",
                        "shareBps"
                      ],
                      "additionalProperties": false
                    },
                    "maxItems": 8,
                    "minItems": 1
                  },
                  "initialShareBps": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 10000
                  },
                  "multiplesBps": {
                    "type": "array",
                    "items": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 4294967295
                    },
                    "maxItems": 16,
                    "minItems": 0
                  },
                  "milestoneSharesBps": {
                    "type": "array",
                    "items": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 10000
                    },
                    "maxItems": 16,
                    "minItems": 0
                  },
                  "holdSeconds": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 4294967295
                  },
                  "expiresAfter": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 4294967295
                  }
                },
                "required": [
                  "recipients",
                  "initialShareBps",
                  "multiplesBps",
                  "milestoneSharesBps",
                  "holdSeconds",
                  "expiresAfter"
                ],
                "additionalProperties": false
              },
              "trading": {
                "type": "object",
                "properties": {
                  "rewardMode": {
                    "type": "boolean"
                  },
                  "creatorTaxBps": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 10000
                  },
                  "holderFeeBps": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 10000
                  },
                  "recipients": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "pattern": "^0x[0-9a-fA-F]{40}$"
                    },
                    "maxItems": 32,
                    "minItems": 1
                  },
                  "sharesBps": {
                    "type": "array",
                    "items": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 10000
                    },
                    "maxItems": 32,
                    "minItems": 1
                  }
                },
                "required": [
                  "rewardMode",
                  "creatorTaxBps",
                  "holderFeeBps",
                  "recipients",
                  "sharesBps"
                ],
                "additionalProperties": false
              },
              "identities": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "provider": {
                      "enum": [
                        1,
                        2
                      ]
                    },
                    "subject": {
                      "type": "string",
                      "pattern": "^(0|[1-9][0-9]{0,77})$"
                    }
                  },
                  "required": [
                    "provider",
                    "subject"
                  ],
                  "additionalProperties": false
                },
                "maxItems": 32,
                "minItems": 0
              },
              "presentationHash": {
                "type": "string",
                "pattern": "^0x[0-9a-fA-F]{64}$"
              },
              "launchAt": {
                "type": "integer",
                "minimum": 0,
                "maximum": 1099511627775
              },
              "recoverySeconds": {
                "type": "integer",
                "minimum": 0,
                "maximum": 4294967295
              },
              "withdrawal": {
                "type": "object",
                "properties": {
                  "feeBps": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 10000
                  },
                  "cutoffSeconds": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 4294967295
                  }
                },
                "required": [
                  "feeBps",
                  "cutoffSeconds"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "metadata",
              "quote",
              "saleSalt",
              "economics",
              "rules",
              "reserves",
              "project",
              "trading",
              "identities",
              "presentationHash",
              "launchAt",
              "recoverySeconds"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "kind",
          "creator",
          "request"
        ],
        "additionalProperties": false
      },
      "SaleAction": {
        "anyOf": [
          {
            "type": "object",
            "properties": {
              "operation": {
                "const": "contribute"
              },
              "wallet": {
                "type": "string",
                "pattern": "^0x[0-9a-fA-F]{40}$"
              },
              "sale": {
                "type": "string",
                "pattern": "^0x[0-9a-fA-F]{40}$"
              },
              "tier": {
                "type": "integer",
                "minimum": 0,
                "maximum": 15
              },
              "amount": {
                "type": "string",
                "pattern": "^(0|[1-9][0-9]{0,77})$"
              },
              "proof": {
                "type": "object",
                "properties": {
                  "whitelistCap": {
                    "type": "string",
                    "pattern": "^(0|[1-9][0-9]{0,77})$"
                  },
                  "siblings": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "pattern": "^0x[0-9a-fA-F]{64}$"
                    },
                    "maxItems": 32,
                    "minItems": 0
                  },
                  "snapshotLocks": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "pattern": "^(0|[1-9][0-9]{0,77})$"
                    },
                    "maxItems": 32,
                    "minItems": 0
                  },
                  "currentLocks": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "pattern": "^(0|[1-9][0-9]{0,77})$"
                    },
                    "maxItems": 32,
                    "minItems": 0
                  }
                },
                "required": [
                  "whitelistCap",
                  "siblings",
                  "snapshotLocks",
                  "currentLocks"
                ],
                "additionalProperties": false
              },
              "referrer": {
                "type": "string",
                "pattern": "^0x[0-9a-fA-F]{40}$"
              },
              "nonce": {
                "type": "string",
                "pattern": "^0x[0-9a-fA-F]{64}$"
              },
              "review_hash": {
                "type": "string",
                "pattern": "^0x[0-9a-fA-F]{64}$"
              }
            },
            "required": [
              "operation",
              "wallet",
              "sale",
              "tier",
              "amount",
              "proof",
              "nonce",
              "review_hash"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "operation": {
                "const": "claim_tokens"
              },
              "wallet": {
                "type": "string",
                "pattern": "^0x[0-9a-fA-F]{40}$"
              },
              "sale": {
                "type": "string",
                "pattern": "^0x[0-9a-fA-F]{40}$"
              },
              "ids": {
                "type": "array",
                "items": {
                  "type": "string",
                  "pattern": "^(0|[1-9][0-9]{0,77})$"
                },
                "maxItems": 32,
                "minItems": 1
              }
            },
            "required": [
              "operation",
              "wallet",
              "sale",
              "ids"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "operation": {
                "const": "claim_referrals"
              },
              "wallet": {
                "type": "string",
                "pattern": "^0x[0-9a-fA-F]{40}$"
              },
              "sale": {
                "type": "string",
                "pattern": "^0x[0-9a-fA-F]{40}$"
              },
              "ids": {
                "type": "array",
                "items": {
                  "type": "string",
                  "pattern": "^(0|[1-9][0-9]{0,77})$"
                },
                "maxItems": 32,
                "minItems": 1
              }
            },
            "required": [
              "operation",
              "wallet",
              "sale",
              "ids"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "operation": {
                "const": "claim_rewards"
              },
              "wallet": {
                "type": "string",
                "pattern": "^0x[0-9a-fA-F]{40}$"
              },
              "sale": {
                "type": "string",
                "pattern": "^0x[0-9a-fA-F]{40}$"
              },
              "ids": {
                "type": "array",
                "items": {
                  "type": "string",
                  "pattern": "^(0|[1-9][0-9]{0,77})$"
                },
                "maxItems": 32,
                "minItems": 0
              },
              "wrap_native": {
                "type": "boolean"
              }
            },
            "required": [
              "operation",
              "wallet",
              "sale",
              "ids"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "operation": {
                "const": "claim_refunds"
              },
              "wallet": {
                "type": "string",
                "pattern": "^0x[0-9a-fA-F]{40}$"
              },
              "sale": {
                "type": "string",
                "pattern": "^0x[0-9a-fA-F]{40}$"
              },
              "ids": {
                "type": "array",
                "items": {
                  "type": "string",
                  "pattern": "^(0|[1-9][0-9]{0,77})$"
                },
                "maxItems": 32,
                "minItems": 1
              },
              "wrap_native": {
                "type": "boolean"
              }
            },
            "required": [
              "operation",
              "wallet",
              "sale",
              "ids"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "operation": {
                "const": "emergency_withdraw"
              },
              "wallet": {
                "type": "string",
                "pattern": "^0x[0-9a-fA-F]{40}$"
              },
              "sale": {
                "type": "string",
                "pattern": "^0x[0-9a-fA-F]{40}$"
              },
              "ids": {
                "type": "array",
                "items": {
                  "type": "string",
                  "pattern": "^(0|[1-9][0-9]{0,77})$"
                },
                "maxItems": 8,
                "minItems": 1
              },
              "wrap_native": {
                "type": "boolean"
              }
            },
            "required": [
              "operation",
              "wallet",
              "sale",
              "ids"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "operation": {
                "const": "transfer_allocation"
              },
              "wallet": {
                "type": "string",
                "pattern": "^0x[0-9a-fA-F]{40}$"
              },
              "sale": {
                "type": "string",
                "pattern": "^0x[0-9a-fA-F]{40}$"
              },
              "id": {
                "type": "string",
                "pattern": "^(0|[1-9][0-9]{0,77})$"
              },
              "recipient": {
                "type": "string",
                "pattern": "^0x[0-9a-fA-F]{40}$"
              }
            },
            "required": [
              "operation",
              "wallet",
              "sale",
              "id",
              "recipient"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "operation": {
                "const": "materialise"
              },
              "wallet": {
                "type": "string",
                "pattern": "^0x[0-9a-fA-F]{40}$"
              },
              "sale": {
                "type": "string",
                "pattern": "^0x[0-9a-fA-F]{40}$"
              },
              "id": {
                "type": "string",
                "pattern": "^(0|[1-9][0-9]{0,77})$"
              }
            },
            "required": [
              "operation",
              "wallet",
              "sale",
              "id"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "operation": {
                "const": "set_presentation"
              },
              "wallet": {
                "type": "string",
                "pattern": "^0x[0-9a-fA-F]{40}$"
              },
              "sale": {
                "type": "string",
                "pattern": "^0x[0-9a-fA-F]{40}$"
              },
              "presentation_hash": {
                "type": "string",
                "pattern": "^0x[0-9a-fA-F]{64}$"
              }
            },
            "required": [
              "operation",
              "wallet",
              "sale",
              "presentation_hash"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "operation": {
                "const": "finalise"
              },
              "wallet": {
                "type": "string",
                "pattern": "^0x[0-9a-fA-F]{40}$"
              },
              "sale": {
                "type": "string",
                "pattern": "^0x[0-9a-fA-F]{40}$"
              }
            },
            "required": [
              "operation",
              "wallet",
              "sale"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "operation": {
                "const": "release_project"
              },
              "wallet": {
                "type": "string",
                "pattern": "^0x[0-9a-fA-F]{40}$"
              },
              "sale": {
                "type": "string",
                "pattern": "^0x[0-9a-fA-F]{40}$"
              }
            },
            "required": [
              "operation",
              "wallet",
              "sale"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "operation": {
                "const": "cancel"
              },
              "wallet": {
                "type": "string",
                "pattern": "^0x[0-9a-fA-F]{40}$"
              },
              "sale": {
                "type": "string",
                "pattern": "^0x[0-9a-fA-F]{40}$"
              }
            },
            "required": [
              "operation",
              "wallet",
              "sale"
            ],
            "additionalProperties": false
          }
        ]
      },
      "SaleCreationPlan": {
        "type": "object",
        "properties": {
          "schema": {
            "const": "gama-sale-launch/1"
          },
          "chain_id": {
            "type": "integer",
            "minimum": 0,
            "maximum": 4294967295
          },
          "factory": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]{40}$"
          },
          "sale_factory": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]{40}$"
          },
          "source_commit": {
            "type": "string"
          },
          "intent_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "config_hash": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]{64}$"
          },
          "creator": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]{40}$"
          },
          "plan_id": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]{64}$"
          },
          "request": {
            "type": "object",
            "properties": {
              "metadata": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 64
                  },
                  "symbol": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 16
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 2048
                  },
                  "logo": {
                    "type": "string",
                    "maxLength": 512
                  },
                  "socials": {
                    "type": "object",
                    "properties": {
                      "twitter": {
                        "type": "string",
                        "maxLength": 256
                      },
                      "telegram": {
                        "type": "string",
                        "maxLength": 256
                      },
                      "discord": {
                        "type": "string",
                        "maxLength": 256
                      },
                      "website": {
                        "type": "string",
                        "maxLength": 256
                      },
                      "farcaster": {
                        "type": "string",
                        "maxLength": 256
                      }
                    },
                    "required": [],
                    "additionalProperties": false
                  }
                },
                "required": [
                  "name",
                  "symbol"
                ],
                "additionalProperties": false
              },
              "quote": {
                "type": "string",
                "pattern": "^0x[0-9a-fA-F]{40}$"
              },
              "saleSalt": {
                "type": "string",
                "pattern": "^0x[0-9a-fA-F]{64}$"
              },
              "economics": {
                "type": "object",
                "properties": {
                  "format": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 3
                  },
                  "supply": {
                    "type": "string",
                    "pattern": "^(0|[1-9][0-9]{0,77})$"
                  },
                  "reserves": {
                    "type": "string",
                    "pattern": "^(0|[1-9][0-9]{0,77})$"
                  },
                  "softCap": {
                    "type": "string",
                    "pattern": "^(0|[1-9][0-9]{0,77})$"
                  },
                  "tiers": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "inventory": {
                          "type": "string",
                          "pattern": "^(0|[1-9][0-9]{0,77})$"
                        },
                        "price": {
                          "type": "object",
                          "properties": {
                            "quote": {
                              "type": "string",
                              "pattern": "^(0|[1-9][0-9]{0,77})$"
                            },
                            "tokens": {
                              "type": "string",
                              "pattern": "^(0|[1-9][0-9]{0,77})$"
                            }
                          },
                          "required": [
                            "quote",
                            "tokens"
                          ],
                          "additionalProperties": false
                        },
                        "reservedBps": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 10000
                        },
                        "releaseUnused": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "inventory",
                        "price",
                        "reservedBps",
                        "releaseUnused"
                      ],
                      "additionalProperties": false
                    },
                    "maxItems": 16,
                    "minItems": 1
                  },
                  "rollover": {
                    "type": "boolean"
                  },
                  "opening": {
                    "type": "object",
                    "properties": {
                      "quote": {
                        "type": "string",
                        "pattern": "^(0|[1-9][0-9]{0,77})$"
                      },
                      "tokens": {
                        "type": "string",
                        "pattern": "^(0|[1-9][0-9]{0,77})$"
                      }
                    },
                    "required": [
                      "quote",
                      "tokens"
                    ],
                    "additionalProperties": false
                  },
                  "fairOpeningMultipleBps": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 4294967295
                  },
                  "platformQuoteBps": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 10000
                  },
                  "platformTokenBps": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 10000
                  },
                  "referralBps": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 10000
                  },
                  "liquidityBps": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 10000
                  }
                },
                "required": [
                  "format",
                  "supply",
                  "reserves",
                  "softCap",
                  "tiers",
                  "rollover",
                  "opening",
                  "fairOpeningMultipleBps",
                  "platformQuoteBps",
                  "platformTokenBps",
                  "referralBps",
                  "liquidityBps"
                ],
                "additionalProperties": false
              },
              "rules": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "opensAt": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 1099511627775
                    },
                    "closesAt": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 1099511627775
                    },
                    "access": {
                      "type": "object",
                      "properties": {
                        "kind": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 2
                        },
                        "whitelistRoot": {
                          "type": "string",
                          "pattern": "^0x[0-9a-fA-F]{64}$"
                        },
                        "whitelistContent": {
                          "type": "string",
                          "pattern": "^0x[0-9a-fA-F]{64}$"
                        },
                        "minimum": {
                          "type": "string",
                          "pattern": "^(0|[1-9][0-9]{0,77})$"
                        },
                        "maximum": {
                          "type": "string",
                          "pattern": "^(0|[1-9][0-9]{0,77})$"
                        },
                        "publicAt": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 1099511627775
                        },
                        "gamaMinimum": {
                          "type": "string",
                          "pattern": "^(0|[1-9][0-9]{0,77})$"
                        },
                        "snapshotBlock": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 281474976710655
                        },
                        "earlyUntil": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 1099511627775
                        },
                        "releaseReservedAt": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 1099511627775
                        }
                      },
                      "required": [
                        "kind",
                        "whitelistRoot",
                        "whitelistContent",
                        "minimum",
                        "maximum",
                        "publicAt",
                        "gamaMinimum",
                        "snapshotBlock",
                        "earlyUntil",
                        "releaseReservedAt"
                      ],
                      "additionalProperties": false
                    },
                    "vesting": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "time": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 4294967295
                          },
                          "share": {
                            "type": "string",
                            "pattern": "^(0|[1-9][0-9]{0,77})$"
                          }
                        },
                        "required": [
                          "time",
                          "share"
                        ],
                        "additionalProperties": false
                      },
                      "maxItems": 64,
                      "minItems": 1
                    }
                  },
                  "required": [
                    "opensAt",
                    "closesAt",
                    "access",
                    "vesting"
                  ],
                  "additionalProperties": false
                },
                "maxItems": 16,
                "minItems": 1
              },
              "reserves": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "recipient": {
                      "type": "string",
                      "pattern": "^0x[0-9a-fA-F]{40}$"
                    },
                    "amount": {
                      "type": "string",
                      "pattern": "^(0|[1-9][0-9]{0,77})$"
                    },
                    "label": {
                      "type": "string",
                      "maxLength": 64
                    },
                    "vesting": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "time": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 4294967295
                          },
                          "share": {
                            "type": "string",
                            "pattern": "^(0|[1-9][0-9]{0,77})$"
                          }
                        },
                        "required": [
                          "time",
                          "share"
                        ],
                        "additionalProperties": false
                      },
                      "maxItems": 64,
                      "minItems": 1
                    }
                  },
                  "required": [
                    "recipient",
                    "amount",
                    "label",
                    "vesting"
                  ],
                  "additionalProperties": false
                },
                "maxItems": 32,
                "minItems": 0
              },
              "project": {
                "type": "object",
                "properties": {
                  "recipients": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "account": {
                          "type": "string",
                          "pattern": "^0x[0-9a-fA-F]{40}$"
                        },
                        "shareBps": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 10000
                        }
                      },
                      "required": [
                        "account",
                        "shareBps"
                      ],
                      "additionalProperties": false
                    },
                    "maxItems": 8,
                    "minItems": 1
                  },
                  "initialShareBps": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 10000
                  },
                  "multiplesBps": {
                    "type": "array",
                    "items": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 4294967295
                    },
                    "maxItems": 16,
                    "minItems": 0
                  },
                  "milestoneSharesBps": {
                    "type": "array",
                    "items": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 10000
                    },
                    "maxItems": 16,
                    "minItems": 0
                  },
                  "holdSeconds": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 4294967295
                  },
                  "expiresAfter": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 4294967295
                  }
                },
                "required": [
                  "recipients",
                  "initialShareBps",
                  "multiplesBps",
                  "milestoneSharesBps",
                  "holdSeconds",
                  "expiresAfter"
                ],
                "additionalProperties": false
              },
              "trading": {
                "type": "object",
                "properties": {
                  "rewardMode": {
                    "type": "boolean"
                  },
                  "creatorTaxBps": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 10000
                  },
                  "holderFeeBps": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 10000
                  },
                  "recipients": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "pattern": "^0x[0-9a-fA-F]{40}$"
                    },
                    "maxItems": 32,
                    "minItems": 1
                  },
                  "sharesBps": {
                    "type": "array",
                    "items": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 10000
                    },
                    "maxItems": 32,
                    "minItems": 1
                  }
                },
                "required": [
                  "rewardMode",
                  "creatorTaxBps",
                  "holderFeeBps",
                  "recipients",
                  "sharesBps"
                ],
                "additionalProperties": false
              },
              "identities": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "provider": {
                      "enum": [
                        1,
                        2
                      ]
                    },
                    "subject": {
                      "type": "string",
                      "pattern": "^(0|[1-9][0-9]{0,77})$"
                    }
                  },
                  "required": [
                    "provider",
                    "subject"
                  ],
                  "additionalProperties": false
                },
                "maxItems": 32,
                "minItems": 0
              },
              "presentationHash": {
                "type": "string",
                "pattern": "^0x[0-9a-fA-F]{64}$"
              },
              "launchAt": {
                "type": "integer",
                "minimum": 0,
                "maximum": 1099511627775
              },
              "recoverySeconds": {
                "type": "integer",
                "minimum": 0,
                "maximum": 4294967295
              },
              "withdrawal": {
                "type": "object",
                "properties": {
                  "feeBps": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 10000
                  },
                  "cutoffSeconds": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 4294967295
                  }
                },
                "required": [
                  "feeBps",
                  "cutoffSeconds"
                ],
                "additionalProperties": false
              },
              "tokenSalt": {
                "type": "string",
                "pattern": "^0x[0-9a-fA-F]{64}$"
              },
              "deadline": {
                "type": "string",
                "pattern": "^(0|[1-9][0-9]{0,77})$"
              }
            },
            "required": [
              "metadata",
              "quote",
              "saleSalt",
              "economics",
              "rules",
              "reserves",
              "project",
              "trading",
              "identities",
              "presentationHash",
              "launchAt",
              "recoverySeconds",
              "tokenSalt",
              "deadline"
            ],
            "additionalProperties": false
          },
          "preview": {
            "type": "object",
            "properties": {
              "sale": {
                "type": "string",
                "pattern": "^0x[0-9a-fA-F]{40}$"
              },
              "token": {
                "type": "string",
                "pattern": "^0x[0-9a-fA-F]{40}$"
              },
              "allocations": {
                "type": "string",
                "pattern": "^0x[0-9a-fA-F]{40}$"
              },
              "tokenInitCodeHash": {
                "type": "string",
                "pattern": "^0x[0-9a-fA-F]{64}$"
              },
              "commitment": {
                "type": "string",
                "pattern": "^0x[0-9a-fA-F]{64}$"
              },
              "trading": {
                "type": "object"
              },
              "budget": {
                "type": "object"
              }
            },
            "required": [
              "sale",
              "token",
              "allocations",
              "tokenInitCodeHash",
              "commitment",
              "trading",
              "budget"
            ],
            "additionalProperties": false
          },
          "sale": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]{40}$"
          },
          "curve": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]{40}$"
          },
          "token": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]{40}$"
          },
          "allocations": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]{40}$"
          },
          "prepared_at": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1099511627775
          },
          "review_block": {
            "type": "string",
            "pattern": "^(0|[1-9][0-9]{0,77})$"
          },
          "review_block_hash": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]{64}$"
          },
          "transaction": {
            "$ref": "#/components/schemas/UnsignedTransaction"
          },
          "approval": {
            "type": "null"
          },
          "gas_note": {
            "type": "string"
          },
          "simulation": {
            "type": "object",
            "properties": {
              "state": {
                "enum": [
                  "passed",
                  "approval_required",
                  "wallet_execution_required",
                  "refused"
                ]
              },
              "gas": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "code": {
                "type": "string"
              },
              "next_action": {
                "type": "string"
              },
              "requirements": {
                "type": "array",
                "maxItems": 2,
                "items": {
                  "type": "object",
                  "properties": {
                    "asset": {
                      "type": "string",
                      "pattern": "^0x[0-9a-fA-F]{40}$"
                    },
                    "required": {
                      "type": "string",
                      "pattern": "^(0|[1-9][0-9]{0,77})$"
                    },
                    "available": {
                      "type": "string",
                      "pattern": "^(0|[1-9][0-9]{0,77})$"
                    },
                    "includes_gas": {
                      "const": false
                    }
                  },
                  "required": [
                    "asset",
                    "required",
                    "available",
                    "includes_gas"
                  ],
                  "additionalProperties": false
                }
              }
            },
            "required": [
              "state",
              "gas"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "schema",
          "chain_id",
          "factory",
          "sale_factory",
          "source_commit",
          "intent_id",
          "config_hash",
          "creator",
          "plan_id",
          "request",
          "preview",
          "sale",
          "curve",
          "token",
          "allocations",
          "prepared_at",
          "review_block",
          "review_block_hash",
          "transaction",
          "approval",
          "gas_note",
          "simulation"
        ],
        "additionalProperties": false
      },
      "SalePlan": {
        "type": "object",
        "properties": {
          "schema": {
            "const": "gama-sale-action/1"
          },
          "chain_id": {
            "type": "integer",
            "minimum": 0,
            "maximum": 4294967295
          },
          "factory": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]{40}$"
          },
          "source_commit": {
            "type": "string"
          },
          "input": {
            "$ref": "#/components/schemas/SaleAction"
          },
          "state": {
            "type": "object",
            "properties": {
              "token": {
                "type": "string",
                "pattern": "^0x[0-9a-fA-F]{40}$"
              },
              "allocations": {
                "type": "string",
                "pattern": "^0x[0-9a-fA-F]{40}$"
              },
              "quote": {
                "type": "string",
                "pattern": "^0x[0-9a-fA-F]{40}$"
              },
              "review_hash": {
                "type": "string",
                "pattern": "^0x[0-9a-fA-F]{64}$"
              },
              "phase": {
                "type": "integer",
                "minimum": 0,
                "maximum": 3
              },
              "withdrawal": {
                "type": "object",
                "properties": {
                  "fee_bps": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 10000
                  },
                  "cutoff_seconds": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 4294967295
                  },
                  "closes_at": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 1099511627775
                  },
                  "receipts": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "pattern": "^(0|[1-9][0-9]{0,77})$"
                        },
                        "amount": {
                          "type": "string",
                          "pattern": "^(0|[1-9][0-9]{0,77})$"
                        },
                        "penalty": {
                          "type": "string",
                          "pattern": "^(0|[1-9][0-9]{0,77})$"
                        },
                        "returned": {
                          "type": "string",
                          "pattern": "^(0|[1-9][0-9]{0,77})$"
                        }
                      },
                      "required": [
                        "id",
                        "amount",
                        "penalty",
                        "returned"
                      ],
                      "additionalProperties": false
                    },
                    "maxItems": 8,
                    "minItems": 1
                  },
                  "amount": {
                    "type": "string",
                    "pattern": "^(0|[1-9][0-9]{0,77})$"
                  },
                  "penalty": {
                    "type": "string",
                    "pattern": "^(0|[1-9][0-9]{0,77})$"
                  },
                  "returned": {
                    "type": "string",
                    "pattern": "^(0|[1-9][0-9]{0,77})$"
                  }
                },
                "required": [
                  "fee_bps",
                  "cutoff_seconds",
                  "closes_at",
                  "receipts",
                  "amount",
                  "penalty",
                  "returned"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "token",
              "allocations",
              "quote",
              "review_hash",
              "phase"
            ],
            "additionalProperties": false
          },
          "plan_id": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]{64}$"
          },
          "prepared_at": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1099511627775
          },
          "expires_at": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1099511627775
          },
          "review_block": {
            "type": "string",
            "pattern": "^(0|[1-9][0-9]{0,77})$"
          },
          "review_block_hash": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]{64}$"
          },
          "transaction": {
            "$ref": "#/components/schemas/UnsignedTransaction"
          },
          "approval": {
            "anyOf": [
              {
                "type": "null"
              },
              {
                "type": "object",
                "properties": {
                  "chain_id": {
                    "type": "integer"
                  },
                  "from": {
                    "type": "string",
                    "pattern": "^0x[0-9a-fA-F]{40}$"
                  },
                  "to": {
                    "type": "string",
                    "pattern": "^0x[0-9a-fA-F]{40}$"
                  },
                  "data": {
                    "type": "string",
                    "pattern": "^0x[0-9a-fA-F]*$"
                  },
                  "value": {
                    "type": "string",
                    "pattern": "^(0|[1-9][0-9]{0,77})$"
                  },
                  "spender": {
                    "type": "string",
                    "pattern": "^0x[0-9a-fA-F]{40}$"
                  },
                  "amount": {
                    "type": "string",
                    "pattern": "^(0|[1-9][0-9]{0,77})$"
                  },
                  "reset": {
                    "$ref": "#/components/schemas/UnsignedTransaction"
                  }
                },
                "required": [
                  "chain_id",
                  "from",
                  "to",
                  "data",
                  "value",
                  "spender",
                  "amount",
                  "reset"
                ],
                "additionalProperties": false
              }
            ]
          },
          "simulation": {
            "type": "object",
            "properties": {
              "state": {
                "enum": [
                  "passed",
                  "approval_required",
                  "wallet_execution_required",
                  "refused"
                ]
              },
              "gas": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "code": {
                "type": "string"
              },
              "next_action": {
                "type": "string"
              },
              "requirements": {
                "type": "array",
                "maxItems": 2,
                "items": {
                  "type": "object",
                  "properties": {
                    "asset": {
                      "type": "string",
                      "pattern": "^0x[0-9a-fA-F]{40}$"
                    },
                    "required": {
                      "type": "string",
                      "pattern": "^(0|[1-9][0-9]{0,77})$"
                    },
                    "available": {
                      "type": "string",
                      "pattern": "^(0|[1-9][0-9]{0,77})$"
                    },
                    "includes_gas": {
                      "const": false
                    }
                  },
                  "required": [
                    "asset",
                    "required",
                    "available",
                    "includes_gas"
                  ],
                  "additionalProperties": false
                }
              }
            },
            "required": [
              "state",
              "gas"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "schema",
          "chain_id",
          "factory",
          "source_commit",
          "input",
          "state",
          "plan_id",
          "prepared_at",
          "expires_at",
          "review_block",
          "review_block_hash",
          "transaction",
          "approval",
          "simulation"
        ],
        "additionalProperties": false
      },
      "SalePrepared": {
        "type": "object",
        "properties": {
          "plan": {
            "$ref": "#/components/schemas/SalePlan"
          }
        },
        "required": [
          "plan"
        ],
        "additionalProperties": false
      }
    }
  },
  "paths": {
    "/developer/usage": {
      "get": {
        "operationId": "usage",
        "summary": "Own wallet allowances and unfinished launch",
        "security": [
          {
            "DeveloperKey": []
          }
        ],
        "responses": {
          "200": {
            "description": "Result in data. Decimal integer strings preserve exact on-chain amounts.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Usage"
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "413": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Allowance exhausted; Retry-After gives seconds. Reuse the same intent.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/quote-assets": {
      "get": {
        "operationId": "quoteAssets",
        "summary": "Eligible quote assets at one indexed head",
        "security": [],
        "responses": {
          "200": {
            "description": "Result in data. Decimal integer strings preserve exact on-chain amounts.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "maxItems": 50,
                      "items": {
                        "type": "object"
                      }
                    },
                    "head": {
                      "type": "integer"
                    },
                    "block_hash": {
                      "type": "string",
                      "pattern": "^0x[0-9a-fA-F]*$"
                    },
                    "head_at": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "reorg_count": {
                      "type": "integer"
                    },
                    "stale": {
                      "type": "boolean"
                    },
                    "next_cursor": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "cursor_expires_at": {
                      "type": "integer"
                    }
                  },
                  "required": [
                    "data",
                    "head",
                    "block_hash",
                    "reorg_count",
                    "stale",
                    "next_cursor"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "413": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Allowance exhausted; Retry-After gives seconds. Reuse the same intent.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "cursor",
            "in": "query",
            "schema": {
              "type": "string",
              "maxLength": 2048
            }
          }
        ]
      }
    },
    "/launch-capabilities": {
      "get": {
        "operationId": "capabilities",
        "summary": "Deployment, defaults, supported options and allowances",
        "security": [],
        "responses": {
          "200": {
            "description": "Result in data. Decimal integer strings preserve exact on-chain amounts.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "properties": {
                        "chain_id": {
                          "type": "integer"
                        },
                        "factory": {
                          "type": "string",
                          "pattern": "^0x[0-9a-fA-F]{40}$"
                        },
                        "source_commit": {
                          "type": "string"
                        },
                        "deployment": {
                          "type": "string",
                          "pattern": "^0x[0-9a-fA-F]*$"
                        },
                        "schema": {
                          "const": "gama-launch/1"
                        },
                        "server_time": {
                          "type": "integer"
                        },
                        "preparation_available": {
                          "type": "boolean"
                        },
                        "authentication": {
                          "const": "X-Gama-Key"
                        },
                        "signing": {
                          "const": "caller-wallet"
                        },
                        "modes": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "opening_lock": {
                          "type": "boolean"
                        },
                        "defaults": {
                          "type": "object",
                          "additionalProperties": {
                            "type": [
                              "string",
                              "number",
                              "boolean"
                            ]
                          }
                        },
                        "limits": {
                          "type": "object",
                          "additionalProperties": {
                            "type": "number"
                          }
                        },
                        "quote_assets": {
                          "type": "string"
                        },
                        "documentation": {
                          "type": "string"
                        },
                        "openapi": {
                          "type": "string"
                        },
                        "agent_guide": {
                          "type": "string"
                        },
                        "client_manifest": {
                          "type": "string"
                        },
                        "capabilities": {
                          "type": "object",
                          "properties": {
                            "lifecycle": {
                              "type": "integer",
                              "minimum": 0
                            },
                            "usage": {
                              "type": "integer",
                              "minimum": 0
                            },
                            "reports": {
                              "type": "integer",
                              "minimum": 0
                            },
                            "events": {
                              "type": "integer",
                              "minimum": 0
                            },
                            "creator_fees": {
                              "type": "integer",
                              "minimum": 0
                            },
                            "social_fees": {
                              "type": "integer",
                              "minimum": 0
                            },
                            "sales": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 1
                            }
                          },
                          "required": [
                            "lifecycle",
                            "usage",
                            "reports",
                            "events",
                            "sales"
                          ],
                          "additionalProperties": false
                        },
                        "creator_policy": {
                          "type": "string"
                        },
                        "creator_fee_operations": {
                          "type": "array",
                          "items": {
                            "enum": [
                              "set_shares",
                              "distribute",
                              "takeover",
                              "execute_takeover",
                              "cancel_takeover"
                            ]
                          }
                        },
                        "social_fee_operations": {
                          "type": "array",
                          "items": {
                            "enum": [
                              "create_vaults",
                              "forward",
                              "claim",
                              "change_wallet"
                            ]
                          }
                        },
                        "social_fees": {
                          "anyOf": [
                            {
                              "type": "null"
                            },
                            {
                              "type": "object",
                              "properties": {
                                "registry": {
                                  "type": "string",
                                  "pattern": "^0x[0-9a-fA-F]{40}$"
                                },
                                "providers": {
                                  "type": "array",
                                  "items": {
                                    "enum": [
                                      "github",
                                      "x"
                                    ]
                                  }
                                },
                                "resolve": {
                                  "type": "string"
                                },
                                "claim": {
                                  "type": "string"
                                }
                              },
                              "required": [
                                "registry",
                                "providers",
                                "resolve",
                                "claim"
                              ],
                              "additionalProperties": false
                            }
                          ]
                        },
                        "sale_operations": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          },
                          "maxItems": 16,
                          "minItems": 0
                        },
                        "sale_policy": {
                          "type": [
                            "string",
                            "null"
                          ]
                        }
                      },
                      "required": [
                        "chain_id",
                        "factory",
                        "source_commit",
                        "deployment",
                        "schema",
                        "server_time",
                        "preparation_available",
                        "authentication",
                        "signing",
                        "modes",
                        "opening_lock",
                        "defaults",
                        "limits",
                        "quote_assets",
                        "documentation",
                        "openapi",
                        "agent_guide",
                        "client_manifest",
                        "capabilities",
                        "sale_operations"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "413": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Allowance exhausted; Retry-After gives seconds. Reuse the same intent.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/developer/challenges": {
      "post": {
        "operationId": "challenge",
        "summary": "Request one five-minute wallet challenge for exactly one management action",
        "security": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "wallet": {
                    "type": "string",
                    "pattern": "^0x[0-9a-fA-F]{40}$"
                  },
                  "action": {
                    "enum": [
                      "create",
                      "list",
                      "revoke",
                      "rotate"
                    ]
                  },
                  "options": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string"
                      },
                      "label": {
                        "type": "string",
                        "maxLength": 64
                      },
                      "scopes": {
                        "type": "array",
                        "items": {
                          "enum": [
                            "read",
                            "prepare",
                            "upload"
                          ]
                        }
                      },
                      "expires_at": {
                        "type": [
                          "integer",
                          "null"
                        ]
                      }
                    },
                    "required": [],
                    "additionalProperties": false
                  }
                },
                "required": [
                  "wallet",
                  "action"
                ],
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Result in data. Decimal integer strings preserve exact on-chain amounts.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "properties": {
                        "chain_id": {
                          "type": "integer"
                        },
                        "factory": {
                          "type": "string",
                          "pattern": "^0x[0-9a-fA-F]{40}$"
                        },
                        "source_commit": {
                          "type": "string"
                        },
                        "deployment": {
                          "type": "string",
                          "pattern": "^0x[0-9a-fA-F]*$"
                        },
                        "id": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "expires_at": {
                          "type": "integer"
                        },
                        "action": {
                          "enum": [
                            "create",
                            "list",
                            "revoke",
                            "rotate"
                          ]
                        },
                        "options": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string"
                            },
                            "label": {
                              "type": "string",
                              "maxLength": 64
                            },
                            "scopes": {
                              "type": "array",
                              "items": {
                                "enum": [
                                  "read",
                                  "prepare",
                                  "upload"
                                ]
                              }
                            },
                            "expires_at": {
                              "type": [
                                "integer",
                                "null"
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": false
                        }
                      },
                      "required": [
                        "chain_id",
                        "factory",
                        "source_commit",
                        "deployment",
                        "id",
                        "message",
                        "expires_at",
                        "action",
                        "options"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "413": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Allowance exhausted; Retry-After gives seconds. Reuse the same intent.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/developer/keys": {
      "post": {
        "operationId": "manageKeys",
        "summary": "Consume the signed challenge atomically; new key is returned once",
        "security": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "challenge": {
                    "type": "string",
                    "pattern": "^[a-f0-9]{32}$"
                  },
                  "signature": {
                    "type": "string",
                    "maxLength": 8194
                  }
                },
                "required": [
                  "challenge",
                  "signature"
                ],
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Result in data. Decimal integer strings preserve exact on-chain amounts.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "$ref": "#/components/schemas/Key"
                        },
                        {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string"
                            },
                            "revoked": {
                              "const": true
                            }
                          },
                          "required": [
                            "id",
                            "revoked"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "keys": {
                              "type": "array",
                              "items": {
                                "$ref": "#/components/schemas/Key"
                              }
                            },
                            "intents": {
                              "type": "array",
                              "items": {
                                "$ref": "#/components/schemas/IntentSummary"
                              }
                            },
                            "usage": {
                              "$ref": "#/components/schemas/Usage"
                            }
                          },
                          "required": [
                            "keys",
                            "intents"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "413": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Allowance exhausted; Retry-After gives seconds. Reuse the same intent.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/developer/images": {
      "post": {
        "operationId": "uploadImage",
        "summary": "Upload original image bytes; no remote URL fetching",
        "security": [
          {
            "DeveloperKey": []
          }
        ],
        "responses": {
          "200": {
            "description": "Result in data. Decimal integer strings preserve exact on-chain amounts.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "properties": {
                        "url": {
                          "type": "string"
                        },
                        "ipfs": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "url"
                      ]
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "413": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Allowance exhausted; Retry-After gives seconds. Reuse the same intent.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "image/png": {
              "schema": {
                "type": "string",
                "format": "binary",
                "maxLength": 5000000
              }
            },
            "image/jpeg": {
              "schema": {
                "type": "string",
                "format": "binary",
                "maxLength": 5000000
              }
            },
            "image/webp": {
              "schema": {
                "type": "string",
                "format": "binary",
                "maxLength": 5000000
              }
            }
          }
        },
        "parameters": [
          {
            "name": "variant",
            "in": "query",
            "schema": {
              "enum": [
                "cover"
              ]
            }
          }
        ]
      }
    },
    "/launch-intents": {
      "get": {
        "operationId": "listIntents",
        "summary": "List up to 100 of this developer’s recent intents",
        "security": [
          {
            "DeveloperKey": []
          }
        ],
        "responses": {
          "200": {
            "description": "Result in data. Decimal integer strings preserve exact on-chain amounts.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "properties": {
                        "intents": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/IntentSummary"
                          },
                          "maxItems": 100
                        }
                      },
                      "required": [
                        "intents"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "413": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Allowance exhausted; Retry-After gives seconds. Reuse the same intent.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      },
      "post": {
        "operationId": "createIntent",
        "summary": "Save immutable choices under a timestamped idempotency ID before preparing",
        "security": [
          {
            "DeveloperKey": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                  },
                  "config": {
                    "anyOf": [
                      {
                        "$ref": "#/components/schemas/LaunchConfig"
                      },
                      {
                        "$ref": "#/components/schemas/SaleConfig"
                      }
                    ]
                  }
                },
                "required": [
                  "id",
                  "config"
                ],
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Result in data. Decimal integer strings preserve exact on-chain amounts.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Intent"
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "413": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Allowance exhausted; Retry-After gives seconds. Reuse the same intent.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/launch-intents/{id}": {
      "parameters": [
        {
          "name": "id",
          "in": "path",
          "required": true,
          "schema": {
            "type": "string",
            "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
          }
        }
      ],
      "get": {
        "operationId": "getIntent",
        "summary": "Recover preparations, exact submitted hashes, chain confirmation and indexer visibility",
        "security": [
          {
            "DeveloperKey": []
          }
        ],
        "responses": {
          "200": {
            "description": "Result in data. Decimal integer strings preserve exact on-chain amounts.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Intent"
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "413": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Allowance exhausted; Retry-After gives seconds. Reuse the same intent.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/launch-intents/{id}/prepare": {
      "parameters": [
        {
          "name": "id",
          "in": "path",
          "required": true,
          "schema": {
            "type": "string",
            "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
          }
        }
      ],
      "post": {
        "operationId": "prepareIntent",
        "summary": "Prepare unsigned approval and creation; retain all earlier attempts",
        "security": [
          {
            "DeveloperKey": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {},
                "required": [],
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Result in data. Decimal integer strings preserve exact on-chain amounts.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "plan": {
                          "anyOf": [
                            {
                              "$ref": "#/components/schemas/Plan"
                            },
                            {
                              "$ref": "#/components/schemas/SaleCreationPlan"
                            }
                          ]
                        },
                        "recovery": {
                          "$ref": "#/components/schemas/Recovery"
                        },
                        "lifecycle": {
                          "$ref": "#/components/schemas/Lifecycle"
                        }
                      },
                      "required": [
                        "id"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "413": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Allowance exhausted; Retry-After gives seconds. Reuse the same intent.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/launch-intents/{id}/transactions": {
      "parameters": [
        {
          "name": "id",
          "in": "path",
          "required": true,
          "schema": {
            "type": "string",
            "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
          }
        }
      ],
      "post": {
        "operationId": "trackTransaction",
        "summary": "Associate a matching transaction hash; signed transaction bytes are never accepted",
        "security": [
          {
            "DeveloperKey": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "hash": {
                    "type": "string",
                    "pattern": "^0x[0-9a-fA-F]{64}$"
                  }
                },
                "required": [
                  "hash"
                ],
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Result in data. Decimal integer strings preserve exact on-chain amounts.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Intent"
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "413": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Allowance exhausted; Retry-After gives seconds. Reuse the same intent.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/launch-intents/{id}/archive": {
      "parameters": [
        {
          "name": "id",
          "in": "path",
          "required": true,
          "schema": {
            "type": "string",
            "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
          }
        }
      ],
      "post": {
        "operationId": "archiveIntent",
        "summary": "Free an unused intent slot only after all preparation deadlines have finalized; never cancels a transaction",
        "security": [
          {
            "DeveloperKey": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {},
                "required": [],
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Result in data. Decimal integer strings preserve exact on-chain amounts.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "archived": {
                          "const": true
                        },
                        "recovery": {
                          "$ref": "#/components/schemas/Recovery"
                        }
                      },
                      "required": [
                        "id",
                        "archived"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "413": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Allowance exhausted; Retry-After gives seconds. Reuse the same intent.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/wallets/{wallet}/earnings": {
      "get": {
        "operationId": "walletEarnings",
        "summary": "Exact-period recipient earnings and paid amounts; current claimable is separate. Explicit wallet required.",
        "parameters": [
          {
            "name": "wallet",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^0x[0-9a-fA-F]{40}$"
            }
          },
          {
            "name": "period",
            "in": "query",
            "schema": {
              "enum": [
                "24h",
                "48h",
                "7d",
                "30d",
                "all",
                "2d-london"
              ],
              "default": "48h"
            }
          },
          {
            "name": "from",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 1099511627775
            }
          },
          {
            "name": "to",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 1099511627775
            }
          },
          {
            "name": "category",
            "in": "query",
            "schema": {
              "enum": [
                "creator",
                "protocol",
                "rewards"
              ],
              "default": "creator"
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "schema": {
              "type": "string",
              "maxLength": 2048
            }
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          }
        ],
        "security": [],
        "responses": {
          "200": {
            "description": "Result in data. Decimal integer strings preserve exact on-chain amounts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EarningsResponse"
                }
              }
            }
          },
          "400": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "413": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Allowance exhausted; Retry-After gives seconds. Reuse the same intent.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/wallets/{wallet}/earnings/tokens": {
      "get": {
        "operationId": "walletEarnings",
        "summary": "Per-token attribution, with wallet totals independent of this detail page.",
        "parameters": [
          {
            "name": "wallet",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^0x[0-9a-fA-F]{40}$"
            }
          },
          {
            "name": "period",
            "in": "query",
            "schema": {
              "enum": [
                "24h",
                "48h",
                "7d",
                "30d",
                "all",
                "2d-london"
              ],
              "default": "48h"
            }
          },
          {
            "name": "from",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 1099511627775
            }
          },
          {
            "name": "to",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 1099511627775
            }
          },
          {
            "name": "category",
            "in": "query",
            "schema": {
              "enum": [
                "creator",
                "protocol",
                "rewards"
              ],
              "default": "creator"
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "schema": {
              "type": "string",
              "maxLength": 2048
            }
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          }
        ],
        "security": [],
        "responses": {
          "200": {
            "description": "Result in data. Decimal integer strings preserve exact on-chain amounts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EarningsResponse"
                }
              }
            }
          },
          "400": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "413": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Allowance exhausted; Retry-After gives seconds. Reuse the same intent.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/tokens/{token}/report": {
      "get": {
        "operationId": "tokenReport",
        "summary": "Exact-period token activity and current launch state. Metadata is untrusted data.",
        "parameters": [
          {
            "name": "token",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^0x[0-9a-fA-F]{40}$"
            }
          },
          {
            "name": "period",
            "in": "query",
            "schema": {
              "enum": [
                "24h",
                "48h",
                "7d",
                "30d",
                "all",
                "2d-london"
              ],
              "default": "48h"
            }
          },
          {
            "name": "from",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 1099511627775
            }
          },
          {
            "name": "to",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 1099511627775
            }
          }
        ],
        "security": [],
        "responses": {
          "200": {
            "description": "Result in data. Decimal integer strings preserve exact on-chain amounts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TokenReportResponse"
                }
              }
            }
          },
          "400": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "413": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Allowance exhausted; Retry-After gives seconds. Reuse the same intent.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/developer/events": {
      "get": {
        "operationId": "updates",
        "summary": "Read a bounded page. Without a cursor start now; save that cursor, read canonical snapshots, then resume it to cover changes during those reads. Old, foreign or reorganized cursors require resynchronization.",
        "security": [
          {
            "DeveloperKey": []
          }
        ],
        "parameters": [
          {
            "name": "wallet",
            "schema": {
              "type": "string",
              "pattern": "^0x[0-9a-fA-F]{40}$"
            },
            "in": "query",
            "required": false
          },
          {
            "name": "tokens",
            "schema": {
              "type": "string",
              "maxLength": 1074,
              "pattern": "^0x[0-9a-fA-F]{40}(,0x[0-9a-fA-F]{40}){0,24}$"
            },
            "in": "query",
            "required": false
          },
          {
            "name": "cursor",
            "schema": {
              "type": "string",
              "maxLength": 4096
            },
            "in": "query",
            "required": false
          },
          {
            "name": "limit",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100
            },
            "in": "query",
            "required": false
          }
        ],
        "responses": {
          "200": {
            "description": "Result in data. Decimal integer strings preserve exact on-chain amounts.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Updates"
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "413": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Allowance exhausted; Retry-After gives seconds. Reuse the same intent.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/developer/events/stream": {
      "get": {
        "operationId": "subscribeUpdates",
        "summary": "One authenticated stream per wallet, 16 globally and two per client network. Connections renew after 120 seconds. Send X-Gama-Key, never a query credential. Last-Event-ID resumes the same filter. Errors close the stream; resync_required needs canonical snapshots.",
        "security": [
          {
            "DeveloperKey": []
          }
        ],
        "parameters": [
          {
            "name": "wallet",
            "schema": {
              "type": "string",
              "pattern": "^0x[0-9a-fA-F]{40}$"
            },
            "in": "query",
            "required": false
          },
          {
            "name": "tokens",
            "schema": {
              "type": "string",
              "maxLength": 1074,
              "pattern": "^0x[0-9a-fA-F]{40}(,0x[0-9a-fA-F]{40}){0,24}$"
            },
            "in": "query",
            "required": false
          },
          {
            "name": "cursor",
            "schema": {
              "type": "string",
              "maxLength": 4096
            },
            "in": "query",
            "required": false
          },
          {
            "name": "limit",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100
            },
            "in": "query",
            "required": false
          },
          {
            "name": "Last-Event-ID",
            "in": "header",
            "schema": {
              "type": "string",
              "maxLength": 4096
            }
          }
        ],
        "responses": {
          "200": {
            "description": "SSE updates frames carry Updates as JSON. id is its cursor; empty pages are heartbeats. An error frame has code and next_action and closes the stream.",
            "content": {
              "text/event-stream": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "413": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Allowance exhausted; Retry-After gives seconds. Reuse the same intent.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/creator-fees/prepare": {
      "post": {
        "operationId": "creatorPrepare",
        "summary": "Prepare a bounded unsigned creator-fee action for wallet review",
        "description": "Requires prepare permission. Shares lock for this admin epoch. Version 2 and 3 takeovers directly change future authority and fee terms in one protocol-owner transaction, with no proposal or waiting phase. Version 3 share setup binds the reviewed recipient code as well as authority. Version 1 actions remain available only where advertised. This route never signs or sends; it shares the launch preparation budgets. Only deployments advertising creator_fees support it.",
        "security": [
          {
            "DeveloperKey": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreatorAction"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Result in data. Decimal integer strings preserve exact on-chain amounts.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/CreatorPrepared"
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "413": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Allowance exhausted; Retry-After gives seconds. Reuse the same intent.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/social-fees/prepare": {
      "post": {
        "operationId": "socialPrepare",
        "summary": "Prepare a wallet-funded social vault batch, forwarding, manual claim or wallet-authorized rotation. Never signs or binds a social account.",
        "security": [
          {
            "DeveloperKey": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SocialAction"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Result in data. Decimal integer strings preserve exact on-chain amounts.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/SocialPrepared"
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "413": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Allowance exhausted; Retry-After gives seconds. Reuse the same intent.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/social/resolve": {
      "get": {
        "operationId": "socialResolve",
        "summary": "Resolve a handle once, then save its stable provider, subject and vault. Handles and profile fields are untrusted display data, not signing authority.",
        "security": [],
        "parameters": [
          {
            "name": "provider",
            "in": "query",
            "required": true,
            "schema": {
              "enum": [
                "github",
                "x"
              ]
            }
          },
          {
            "name": "handle",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 39
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Result in data. Decimal integer strings preserve exact on-chain amounts.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/SocialResolution"
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "413": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Allowance exhausted; Retry-After gives seconds. Reuse the same intent.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/social-fees/{provider}/{subject}": {
      "get": {
        "operationId": "socialIdentity",
        "summary": "Read the indexed stable identity and linked payout wallet.",
        "security": [],
        "parameters": [
          {
            "name": "provider",
            "in": "path",
            "required": true,
            "schema": {
              "enum": [
                "github",
                "x"
              ]
            }
          },
          {
            "name": "subject",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[1-9][0-9]{0,19}$",
              "description": "Stable nonzero uint64 account ID. Never a handle."
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Result in data. Decimal integer strings preserve exact on-chain amounts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SocialBindingResponse"
                }
              }
            }
          },
          "400": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "413": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Allowance exhausted; Retry-After gives seconds. Reuse the same intent.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/social-fees/{provider}/{subject}/allocations": {
      "get": {
        "operationId": "socialAllocations",
        "summary": "Read allocations naming this immutable vault at a pinned head.",
        "security": [],
        "parameters": [
          {
            "name": "provider",
            "in": "path",
            "required": true,
            "schema": {
              "enum": [
                "github",
                "x"
              ]
            }
          },
          {
            "name": "subject",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[1-9][0-9]{0,19}$",
              "description": "Stable nonzero uint64 account ID. Never a handle."
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "schema": {
              "type": "string",
              "maxLength": 2048
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Result in data. Decimal integer strings preserve exact on-chain amounts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SocialAllocations"
                }
              }
            }
          },
          "400": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "413": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Allowance exhausted; Retry-After gives seconds. Reuse the same intent.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/social-fees/{provider}/{subject}/credits": {
      "get": {
        "operationId": "socialCredits",
        "summary": "Read remaining credit by custody and asset, with cumulative forwarded and claimed amounts. Forwarding is not new income.",
        "security": [],
        "parameters": [
          {
            "name": "provider",
            "in": "path",
            "required": true,
            "schema": {
              "enum": [
                "github",
                "x"
              ]
            }
          },
          {
            "name": "subject",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[1-9][0-9]{0,19}$",
              "description": "Stable nonzero uint64 account ID. Never a handle."
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "schema": {
              "type": "string",
              "maxLength": 2048
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Result in data. Decimal integer strings preserve exact on-chain amounts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SocialCredits"
                }
              }
            }
          },
          "400": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "413": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Allowance exhausted; Retry-After gives seconds. Reuse the same intent.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/wallets/{wallet}/social-identities": {
      "get": {
        "operationId": "socialIdentities",
        "summary": "Read the social identities currently linked to this payout wallet.",
        "security": [],
        "parameters": [
          {
            "name": "wallet",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^0x[0-9a-fA-F]{40}$"
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "schema": {
              "type": "string",
              "maxLength": 2048
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Result in data. Decimal integer strings preserve exact on-chain amounts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SocialIdentities"
                }
              }
            }
          },
          "400": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "413": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Allowance exhausted; Retry-After gives seconds. Reuse the same intent.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/sales/prepare": {
      "post": {
        "operationId": "salePrepare",
        "summary": "Prepare a typed sale operation; the caller reviews, signs and broadcasts.",
        "security": [
          {
            "DeveloperKey": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SaleAction"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Result in data. Decimal integer strings preserve exact on-chain amounts.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/SalePrepared"
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "413": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Allowance exhausted; Retry-After gives seconds. Reuse the same intent.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/sales/capabilities": {
      "get": {
        "operationId": "saleCapabilities",
        "summary": "Read a canonical bounded presale snapshot. Amounts are decimal atomic-unit strings.",
        "security": [],
        "parameters": [],
        "responses": {
          "200": {
            "description": "Result in data. Decimal integer strings preserve exact on-chain amounts.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "properties": {
                        "data": {
                          "anyOf": [
                            {
                              "type": "object"
                            },
                            {
                              "type": "array",
                              "items": {
                                "type": "object"
                              },
                              "maxItems": 16,
                              "minItems": 0
                            }
                          ]
                        },
                        "head": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 1099511627775
                        },
                        "head_at": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "block_hash": {
                          "type": "string",
                          "pattern": "^0x[0-9a-fA-F]{64}$"
                        },
                        "reorg_count": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 1099511627775
                        },
                        "chain_id": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 4294967295
                        },
                        "stale": {
                          "type": "boolean"
                        },
                        "next_cursor": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "cursor_expires_at": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 1099511627775
                        }
                      },
                      "required": [
                        "data",
                        "head",
                        "block_hash",
                        "reorg_count",
                        "chain_id",
                        "stale"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "413": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Allowance exhausted; Retry-After gives seconds. Reuse the same intent.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/sales": {
      "get": {
        "operationId": "sales",
        "summary": "Read a canonical bounded presale snapshot. Amounts are decimal atomic-unit strings.",
        "security": [],
        "parameters": [
          {
            "name": "cursor",
            "in": "query",
            "schema": {
              "type": "string",
              "maxLength": 4096
            }
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 50
            }
          },
          {
            "name": "state",
            "in": "query",
            "schema": {
              "enum": [
                "upcoming",
                "whitelisted",
                "live",
                "scheduled",
                "finalising",
                "recovery",
                "launched",
                "failed",
                "cancelled",
                "open",
                "ended",
                "all"
              ]
            }
          },
          {
            "name": "format",
            "in": "query",
            "schema": {
              "enum": [
                "fixed",
                "fair",
                "overflow",
                "tiered"
              ]
            }
          },
          {
            "name": "access",
            "in": "query",
            "schema": {
              "enum": [
                "public",
                "whitelisted",
                "whitelisted_first"
              ]
            }
          },
          {
            "name": "sort",
            "in": "query",
            "schema": {
              "enum": [
                "newest",
                "closing",
                "raised",
                "opening"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Result in data. Decimal integer strings preserve exact on-chain amounts.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "maxItems": 50,
                      "minItems": 0
                    },
                    "head": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 1099511627775
                    },
                    "head_at": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "block_hash": {
                      "type": "string",
                      "pattern": "^0x[0-9a-fA-F]{64}$"
                    },
                    "reorg_count": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 1099511627775
                    },
                    "chain_id": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 4294967295
                    },
                    "stale": {
                      "type": "boolean"
                    },
                    "next_cursor": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "cursor_expires_at": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 1099511627775
                    }
                  },
                  "required": [
                    "data",
                    "head",
                    "block_hash",
                    "reorg_count",
                    "chain_id",
                    "stale"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "413": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Allowance exhausted; Retry-After gives seconds. Reuse the same intent.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/sales/{sale}": {
      "get": {
        "operationId": "sale",
        "summary": "Read a canonical bounded presale snapshot. Amounts are decimal atomic-unit strings.",
        "security": [],
        "parameters": [
          {
            "name": "sale",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^0x[0-9a-fA-F]{40}$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Result in data. Decimal integer strings preserve exact on-chain amounts.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "object"
                          },
                          "maxItems": 16,
                          "minItems": 0
                        }
                      ]
                    },
                    "head": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 1099511627775
                    },
                    "head_at": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "block_hash": {
                      "type": "string",
                      "pattern": "^0x[0-9a-fA-F]{64}$"
                    },
                    "reorg_count": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 1099511627775
                    },
                    "chain_id": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 4294967295
                    },
                    "stale": {
                      "type": "boolean"
                    },
                    "next_cursor": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "cursor_expires_at": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 1099511627775
                    }
                  },
                  "required": [
                    "data",
                    "head",
                    "block_hash",
                    "reorg_count",
                    "chain_id",
                    "stale"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "413": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Allowance exhausted; Retry-After gives seconds. Reuse the same intent.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/sales/{sale}/contributions": {
      "get": {
        "operationId": "saleContributions",
        "summary": "Read a canonical bounded presale snapshot. Amounts are decimal atomic-unit strings.",
        "security": [],
        "parameters": [
          {
            "name": "sale",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^0x[0-9a-fA-F]{40}$"
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "schema": {
              "type": "string",
              "maxLength": 4096
            }
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 50
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Result in data. Decimal integer strings preserve exact on-chain amounts.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "maxItems": 50,
                      "minItems": 0
                    },
                    "head": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 1099511627775
                    },
                    "head_at": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "block_hash": {
                      "type": "string",
                      "pattern": "^0x[0-9a-fA-F]{64}$"
                    },
                    "reorg_count": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 1099511627775
                    },
                    "chain_id": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 4294967295
                    },
                    "stale": {
                      "type": "boolean"
                    },
                    "next_cursor": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "cursor_expires_at": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 1099511627775
                    }
                  },
                  "required": [
                    "data",
                    "head",
                    "block_hash",
                    "reorg_count",
                    "chain_id",
                    "stale"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "413": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Allowance exhausted; Retry-After gives seconds. Reuse the same intent.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/sales/{sale}/milestones": {
      "get": {
        "operationId": "saleMilestones",
        "summary": "Read a canonical bounded presale snapshot. Amounts are decimal atomic-unit strings.",
        "security": [],
        "parameters": [
          {
            "name": "sale",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^0x[0-9a-fA-F]{40}$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Result in data. Decimal integer strings preserve exact on-chain amounts.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "object"
                          },
                          "maxItems": 16,
                          "minItems": 0
                        }
                      ]
                    },
                    "head": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 1099511627775
                    },
                    "head_at": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "block_hash": {
                      "type": "string",
                      "pattern": "^0x[0-9a-fA-F]{64}$"
                    },
                    "reorg_count": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 1099511627775
                    },
                    "chain_id": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 4294967295
                    },
                    "stale": {
                      "type": "boolean"
                    },
                    "next_cursor": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "cursor_expires_at": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 1099511627775
                    }
                  },
                  "required": [
                    "data",
                    "head",
                    "block_hash",
                    "reorg_count",
                    "chain_id",
                    "stale"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "413": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Allowance exhausted; Retry-After gives seconds. Reuse the same intent.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/sales/{sale}/wallets/{wallet}": {
      "get": {
        "operationId": "saleWallet",
        "summary": "Read a canonical bounded presale snapshot. Amounts are decimal atomic-unit strings.",
        "security": [],
        "parameters": [
          {
            "name": "sale",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^0x[0-9a-fA-F]{40}$"
            }
          },
          {
            "name": "wallet",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^0x[0-9a-fA-F]{40}$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Result in data. Decimal integer strings preserve exact on-chain amounts.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "object"
                          },
                          "maxItems": 16,
                          "minItems": 0
                        }
                      ]
                    },
                    "head": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 1099511627775
                    },
                    "head_at": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "block_hash": {
                      "type": "string",
                      "pattern": "^0x[0-9a-fA-F]{64}$"
                    },
                    "reorg_count": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 1099511627775
                    },
                    "chain_id": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 4294967295
                    },
                    "stale": {
                      "type": "boolean"
                    },
                    "next_cursor": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "cursor_expires_at": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 1099511627775
                    }
                  },
                  "required": [
                    "data",
                    "head",
                    "block_hash",
                    "reorg_count",
                    "chain_id",
                    "stale"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "413": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Allowance exhausted; Retry-After gives seconds. Reuse the same intent.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/sales/{sale}/eligibility/{wallet}": {
      "get": {
        "operationId": "saleEligibility",
        "summary": "Read a canonical bounded presale snapshot. Amounts are decimal atomic-unit strings.",
        "security": [],
        "parameters": [
          {
            "name": "sale",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^0x[0-9a-fA-F]{40}$"
            }
          },
          {
            "name": "wallet",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^0x[0-9a-fA-F]{40}$"
            }
          },
          {
            "name": "tier",
            "in": "query",
            "required": true,
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 15
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Result in data. Decimal integer strings preserve exact on-chain amounts.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "object"
                          },
                          "maxItems": 16,
                          "minItems": 0
                        }
                      ]
                    },
                    "head": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 1099511627775
                    },
                    "head_at": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "block_hash": {
                      "type": "string",
                      "pattern": "^0x[0-9a-fA-F]{64}$"
                    },
                    "reorg_count": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 1099511627775
                    },
                    "chain_id": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 4294967295
                    },
                    "stale": {
                      "type": "boolean"
                    },
                    "next_cursor": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "cursor_expires_at": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 1099511627775
                    }
                  },
                  "required": [
                    "data",
                    "head",
                    "block_hash",
                    "reorg_count",
                    "chain_id",
                    "stale"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "413": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Allowance exhausted; Retry-After gives seconds. Reuse the same intent.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/wallets/{wallet}/sales": {
      "get": {
        "operationId": "walletSales",
        "summary": "Read a canonical bounded presale snapshot. Amounts are decimal atomic-unit strings.",
        "security": [],
        "parameters": [
          {
            "name": "wallet",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^0x[0-9a-fA-F]{40}$"
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "schema": {
              "type": "string",
              "maxLength": 4096
            }
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 50
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Result in data. Decimal integer strings preserve exact on-chain amounts.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "maxItems": 50,
                      "minItems": 0
                    },
                    "head": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 1099511627775
                    },
                    "head_at": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "block_hash": {
                      "type": "string",
                      "pattern": "^0x[0-9a-fA-F]{64}$"
                    },
                    "reorg_count": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 1099511627775
                    },
                    "chain_id": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 4294967295
                    },
                    "stale": {
                      "type": "boolean"
                    },
                    "next_cursor": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "cursor_expires_at": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 1099511627775
                    }
                  },
                  "required": [
                    "data",
                    "head",
                    "block_hash",
                    "reorg_count",
                    "chain_id",
                    "stale"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "413": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Allowance exhausted; Retry-After gives seconds. Reuse the same intent.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/wallets/{wallet}/sale-contributions": {
      "get": {
        "operationId": "walletSaleContributions",
        "summary": "Read a canonical bounded presale snapshot. Amounts are decimal atomic-unit strings.",
        "security": [],
        "parameters": [
          {
            "name": "wallet",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^0x[0-9a-fA-F]{40}$"
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "schema": {
              "type": "string",
              "maxLength": 4096
            }
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 50
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Result in data. Decimal integer strings preserve exact on-chain amounts.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "maxItems": 50,
                      "minItems": 0
                    },
                    "head": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 1099511627775
                    },
                    "head_at": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "block_hash": {
                      "type": "string",
                      "pattern": "^0x[0-9a-fA-F]{64}$"
                    },
                    "reorg_count": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 1099511627775
                    },
                    "chain_id": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 4294967295
                    },
                    "stale": {
                      "type": "boolean"
                    },
                    "next_cursor": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "cursor_expires_at": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 1099511627775
                    }
                  },
                  "required": [
                    "data",
                    "head",
                    "block_hash",
                    "reorg_count",
                    "chain_id",
                    "stale"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "413": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Allowance exhausted; Retry-After gives seconds. Reuse the same intent.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/wallets/{wallet}/sale-allocations": {
      "get": {
        "operationId": "walletSaleAllocations",
        "summary": "Read a canonical bounded presale snapshot. Amounts are decimal atomic-unit strings.",
        "security": [],
        "parameters": [
          {
            "name": "wallet",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^0x[0-9a-fA-F]{40}$"
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "schema": {
              "type": "string",
              "maxLength": 4096
            }
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 50
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Result in data. Decimal integer strings preserve exact on-chain amounts.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "maxItems": 50,
                      "minItems": 0
                    },
                    "head": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 1099511627775
                    },
                    "head_at": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "block_hash": {
                      "type": "string",
                      "pattern": "^0x[0-9a-fA-F]{64}$"
                    },
                    "reorg_count": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 1099511627775
                    },
                    "chain_id": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 4294967295
                    },
                    "stale": {
                      "type": "boolean"
                    },
                    "next_cursor": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "cursor_expires_at": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 1099511627775
                    }
                  },
                  "required": [
                    "data",
                    "head",
                    "block_hash",
                    "reorg_count",
                    "chain_id",
                    "stale"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "413": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Allowance exhausted; Retry-After gives seconds. Reuse the same intent.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/wallets/{wallet}/sale-claims": {
      "get": {
        "operationId": "walletSaleClaims",
        "summary": "Read a canonical bounded presale snapshot. Amounts are decimal atomic-unit strings.",
        "security": [],
        "parameters": [
          {
            "name": "wallet",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^0x[0-9a-fA-F]{40}$"
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "schema": {
              "type": "string",
              "maxLength": 4096
            }
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 50
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Result in data. Decimal integer strings preserve exact on-chain amounts.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "maxItems": 50,
                      "minItems": 0
                    },
                    "head": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 1099511627775
                    },
                    "head_at": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "block_hash": {
                      "type": "string",
                      "pattern": "^0x[0-9a-fA-F]{64}$"
                    },
                    "reorg_count": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 1099511627775
                    },
                    "chain_id": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 4294967295
                    },
                    "stale": {
                      "type": "boolean"
                    },
                    "next_cursor": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "cursor_expires_at": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 1099511627775
                    }
                  },
                  "required": [
                    "data",
                    "head",
                    "block_hash",
                    "reorg_count",
                    "chain_id",
                    "stale"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "413": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Allowance exhausted; Retry-After gives seconds. Reuse the same intent.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/sales/whitelists/challenge": {
      "post": {
        "operationId": "saleWhitelistChallenge",
        "security": [],
        "summary": "Publish content after a single-use wallet signature. This neither creates a sale nor permits spending.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "wallet": {
                    "type": "string",
                    "pattern": "^0x[0-9a-fA-F]{40}$"
                  },
                  "sale": {
                    "type": "string",
                    "pattern": "^0x[0-9a-fA-F]{40}$"
                  },
                  "content_hash": {
                    "type": "string",
                    "pattern": "^0x[0-9a-fA-F]{64}$"
                  },
                  "tier": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 15
                  }
                },
                "required": [
                  "wallet",
                  "sale",
                  "content_hash",
                  "tier"
                ],
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Result in data. Decimal integer strings preserve exact on-chain amounts.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{32}$"
                        },
                        "message": {
                          "type": "string"
                        },
                        "expires_at": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 1099511627775
                        },
                        "chain_id": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 4294967295
                        },
                        "factory": {
                          "type": "string",
                          "pattern": "^0x[0-9a-fA-F]{40}$"
                        },
                        "source_commit": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "id",
                        "message",
                        "expires_at",
                        "chain_id",
                        "factory",
                        "source_commit"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "413": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Allowance exhausted; Retry-After gives seconds. Reuse the same intent.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/sales/whitelists": {
      "post": {
        "operationId": "saleWhitelistPublish",
        "security": [],
        "summary": "Publish content after a single-use wallet signature. This neither creates a sale nor permits spending.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "challenge": {
                    "type": "string",
                    "pattern": "^[a-f0-9]{32}$"
                  },
                  "signature": {
                    "type": "string",
                    "pattern": "^0x[0-9a-fA-F]*$",
                    "maxLength": 16386
                  },
                  "entries": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "wallet": {
                          "type": "string",
                          "pattern": "^0x[0-9a-fA-F]{40}$"
                        },
                        "cap": {
                          "type": "string",
                          "pattern": "^(0|[1-9][0-9]{0,77})$"
                        }
                      },
                      "required": [
                        "wallet",
                        "cap"
                      ],
                      "additionalProperties": false
                    },
                    "maxItems": 10000,
                    "minItems": 1
                  }
                },
                "required": [
                  "challenge",
                  "signature",
                  "entries"
                ],
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Result in data. Decimal integer strings preserve exact on-chain amounts.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "properties": {
                        "schema": {
                          "type": "string"
                        },
                        "content_hash": {
                          "type": "string",
                          "pattern": "^0x[0-9a-fA-F]{64}$"
                        },
                        "sale": {
                          "type": "string",
                          "pattern": "^0x[0-9a-fA-F]{40}$"
                        },
                        "url": {
                          "type": "string"
                        },
                        "tier": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 15
                        },
                        "root": {
                          "type": "string",
                          "pattern": "^0x[0-9a-fA-F]{64}$"
                        },
                        "count": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 10000
                        }
                      },
                      "required": [
                        "schema",
                        "content_hash",
                        "sale",
                        "url",
                        "tier",
                        "root",
                        "count"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "413": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Allowance exhausted; Retry-After gives seconds. Reuse the same intent.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/sales/whitelists/{content_hash}": {
      "get": {
        "operationId": "saleWhitelist",
        "security": [],
        "summary": "Read immutable public content by its reviewed hash.",
        "parameters": [
          {
            "name": "content_hash",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^0x[0-9a-fA-F]{64}$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Result in data. Decimal integer strings preserve exact on-chain amounts.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object"
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "413": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Allowance exhausted; Retry-After gives seconds. Reuse the same intent.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/sales/presentations/challenge": {
      "post": {
        "operationId": "salePresentationChallenge",
        "security": [],
        "summary": "Publish content after a single-use wallet signature. This neither creates a sale nor permits spending.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "wallet": {
                    "type": "string",
                    "pattern": "^0x[0-9a-fA-F]{40}$"
                  },
                  "sale": {
                    "type": "string",
                    "pattern": "^0x[0-9a-fA-F]{40}$"
                  },
                  "content_hash": {
                    "type": "string",
                    "pattern": "^0x[0-9a-fA-F]{64}$"
                  }
                },
                "required": [
                  "wallet",
                  "sale",
                  "content_hash"
                ],
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Result in data. Decimal integer strings preserve exact on-chain amounts.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{32}$"
                        },
                        "message": {
                          "type": "string"
                        },
                        "expires_at": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 1099511627775
                        },
                        "chain_id": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 4294967295
                        },
                        "factory": {
                          "type": "string",
                          "pattern": "^0x[0-9a-fA-F]{40}$"
                        },
                        "source_commit": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "id",
                        "message",
                        "expires_at",
                        "chain_id",
                        "factory",
                        "source_commit"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "413": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Allowance exhausted; Retry-After gives seconds. Reuse the same intent.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/sales/presentations": {
      "post": {
        "operationId": "salePresentationPublish",
        "security": [],
        "summary": "Publish content after a single-use wallet signature. This neither creates a sale nor permits spending.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "challenge": {
                    "type": "string",
                    "pattern": "^[a-f0-9]{32}$"
                  },
                  "signature": {
                    "type": "string",
                    "pattern": "^0x[0-9a-fA-F]*$",
                    "maxLength": 16386
                  },
                  "presentation": {
                    "type": "object",
                    "properties": {
                      "schema": {
                        "const": "gama-sale-presentation/1"
                      },
                      "chain_id": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 4294967295
                      },
                      "sale": {
                        "type": "string",
                        "pattern": "^0x[0-9a-fA-F]{40}$"
                      },
                      "name": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 64
                      },
                      "symbol": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 16
                      },
                      "pitch": {
                        "type": "string",
                        "maxLength": 320
                      },
                      "description": {
                        "type": "string",
                        "maxLength": 16384
                      },
                      "logo": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "maxLength": 512
                      },
                      "cover": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "maxLength": 512
                      },
                      "links": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "kind": {
                              "enum": [
                                "website",
                                "twitter",
                                "telegram",
                                "discord",
                                "farcaster",
                                "github",
                                "docs",
                                "video"
                              ]
                            },
                            "url": {
                              "type": "string",
                              "maxLength": 1024
                            }
                          },
                          "required": [
                            "kind",
                            "url"
                          ],
                          "additionalProperties": false
                        },
                        "maxItems": 8,
                        "minItems": 0
                      }
                    },
                    "required": [
                      "chain_id",
                      "sale",
                      "name",
                      "symbol",
                      "links"
                    ],
                    "additionalProperties": false
                  }
                },
                "required": [
                  "challenge",
                  "signature",
                  "presentation"
                ],
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Result in data. Decimal integer strings preserve exact on-chain amounts.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "properties": {
                        "schema": {
                          "type": "string"
                        },
                        "content_hash": {
                          "type": "string",
                          "pattern": "^0x[0-9a-fA-F]{64}$"
                        },
                        "sale": {
                          "type": "string",
                          "pattern": "^0x[0-9a-fA-F]{40}$"
                        },
                        "url": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "schema",
                        "content_hash",
                        "sale",
                        "url"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "413": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Allowance exhausted; Retry-After gives seconds. Reuse the same intent.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/sales/presentations/{content_hash}": {
      "get": {
        "operationId": "salePresentation",
        "security": [],
        "summary": "Read immutable public content by its reviewed hash.",
        "parameters": [
          {
            "name": "content_hash",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^0x[0-9a-fA-F]{64}$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Result in data. Decimal integer strings preserve exact on-chain amounts.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object"
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "413": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Allowance exhausted; Retry-After gives seconds. Reuse the same intent.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/sales/whitelists/{content_hash}/proof/{wallet}": {
      "get": {
        "operationId": "saleWhitelistProof",
        "security": [],
        "summary": "Read the inclusion proof bound to this chain, sale, tier and wallet.",
        "parameters": [
          {
            "name": "content_hash",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^0x[0-9a-fA-F]{64}$"
            }
          },
          {
            "name": "wallet",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^0x[0-9a-fA-F]{40}$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Result in data. Decimal integer strings preserve exact on-chain amounts.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "properties": {
                        "schema": {
                          "const": "gama-sale-whitelist-proof/1"
                        },
                        "content_hash": {
                          "type": "string",
                          "pattern": "^0x[0-9a-fA-F]{64}$"
                        },
                        "root": {
                          "type": "string",
                          "pattern": "^0x[0-9a-fA-F]{64}$"
                        },
                        "sale": {
                          "type": "string",
                          "pattern": "^0x[0-9a-fA-F]{40}$"
                        },
                        "tier": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 15
                        },
                        "chain_id": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 4294967295
                        },
                        "member": {
                          "type": "boolean"
                        },
                        "proof": {
                          "anyOf": [
                            {
                              "type": "null"
                            },
                            {
                              "type": "object",
                              "properties": {
                                "wallet": {
                                  "type": "string",
                                  "pattern": "^0x[0-9a-fA-F]{40}$"
                                },
                                "cap": {
                                  "type": "string",
                                  "pattern": "^(0|[1-9][0-9]{0,77})$"
                                },
                                "siblings": {
                                  "type": "array",
                                  "items": {
                                    "type": "string",
                                    "pattern": "^0x[0-9a-fA-F]{64}$"
                                  },
                                  "maxItems": 32,
                                  "minItems": 0
                                }
                              },
                              "required": [
                                "wallet",
                                "cap",
                                "siblings"
                              ],
                              "additionalProperties": false
                            }
                          ]
                        }
                      },
                      "required": [
                        "schema",
                        "content_hash",
                        "root",
                        "sale",
                        "tier",
                        "chain_id",
                        "member",
                        "proof"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "413": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Allowance exhausted; Retry-After gives seconds. Reuse the same intent.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Structured error; never retry a wallet send automatically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string"
                        },
                        "next_action": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        },
                        "retry_after": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "blocking_intent_id": {
                          "type": "string",
                          "pattern": "^[a-z0-9]{6,10}-[a-f0-9]{32}$"
                        },
                        "quota_scope": {
                          "enum": [
                            "wallet",
                            "network",
                            "service"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "next_action",
                        "retryable"
                      ],
                      "additionalProperties": false
                    },
                    "request_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}
