@console-wallet/dapp-sdk 2.0.3 → 2.1.0

package/dist/cjs/openapi.json

@@ -0,0 +1,2284 @@
+{
+  "openapi": "3.0.3",
+  "info": {
+    "title": "Canton Wallet Dapp SDK",
+    "version": "2.1.0"
+  },
+  "components": {
+    "schemas": {
+      "AvailabilityResponse": {
+        "additionalProperties": false,
+        "description": "Response for check availability query; mirrors `AvailabilityStatus`.",
+        "properties": {
+          "currentVersion": {
+            "$ref": "#/definitions/WalletVersion"
+          },
+          "isExtensionCapableByVersion": {
+            "type": "boolean"
+          },
+          "minimalCapableVersion": {
+            "$ref": "#/definitions/WalletVersion"
+          },
+          "status": {
+            "$ref": "#/definitions/AvailabilityStatus"
+          }
+        },
+        "required": [
+          "status"
+        ],
+        "type": "object"
+      },
+      "AvailabilityStatus": {
+        "description": "Extension availability status",
+        "enum": [
+          "installed",
+          "notInstalled"
+        ],
+        "type": "string"
+      },
+      "Base64Message": {
+        "additionalProperties": false,
+        "description": "Message body encoded as a base64 string.",
+        "properties": {
+          "base64": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "base64"
+        ],
+        "type": "object"
+      },
+      "BatchEnum": {
+        "description": "Enumerates the kinds of operations that can be batched for signing.",
+        "enum": [
+          "SEND",
+          "UNKNOWN"
+        ],
+        "type": "string"
+      },
+      "BatchSend": {
+        "additionalProperties": false,
+        "description": "A batch of token transfer requests to be signed and sent.",
+        "properties": {
+          "batchType": {
+            "description": "A batch of token transfer requests.",
+            "type": "string",
+            "enum": [
+              "SEND"
+            ]
+          },
+          "requests": {
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "amount": {
+                  "type": "string"
+                },
+                "expireDate": {
+                  "type": "string"
+                },
+                "from": {
+                  "type": "string"
+                },
+                "memo": {
+                  "type": "string"
+                },
+                "to": {
+                  "type": "string"
+                },
+                "token": {
+                  "$ref": "#/definitions/CoinEnum"
+                },
+                "type": {
+                  "$ref": "#/definitions/SendType"
+                }
+              },
+              "required": [
+                "amount",
+                "expireDate",
+                "from",
+                "to",
+                "token",
+                "type"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          }
+        },
+        "required": [
+          "batchType",
+          "requests"
+        ],
+        "type": "object"
+      },
+      "BatchUnknown": {
+        "additionalProperties": false,
+        "description": "A batch of unrecognized or custom requests to be signed.",
+        "properties": {
+          "batchType": {
+            "description": "A batch of unrecognized or custom requests.",
+            "type": "string",
+            "enum": [
+              "UNKNOWN"
+            ]
+          },
+          "hashToSign": {
+            "type": "string"
+          },
+          "requests": {
+            "items": {
+              "additionalProperties": {
+                "type": "string"
+              },
+              "type": "object"
+            },
+            "type": "array"
+          }
+        },
+        "required": [
+          "batchType",
+          "hashToSign",
+          "requests"
+        ],
+        "type": "object"
+      },
+      "CAIP2_CANTON_NETWORKS": {
+        "enum": [
+          "canton:devnet",
+          "canton:testnet",
+          "canton:mainnet"
+        ],
+        "type": "string"
+      },
+      "CANTON_NETWORK_VARIANTS": {
+        "description": "Supported Canton network variants the wallet can operate against.",
+        "enum": [
+          "CANTON_NETWORK_DEV",
+          "CANTON_NETWORK_TEST",
+          "CANTON_NETWORK"
+        ],
+        "type": "string"
+      },
+      "CCPrices": {
+        "additionalProperties": false,
+        "description": "Canton Coin price data transfer object\n\nRepresents the current and historical price points of the native token (Canton Coin) at various significant time intervals. This DTO provides a comprehensive view of price movements for analytical purposes.",
+        "properties": {
+          "current": {
+            "description": "Current price of the token",
+            "format": "decimal",
+            "type": "string",
+            "nullable": true,
+            "example": "0.154"
+          },
+          "one_day_ago": {
+            "description": "Price exactly 24 hours ago\n\nThe price from 24 hours prior to the current time, enabling precise 24-hour change calculations.",
+            "format": "decimal",
+            "type": "string",
+            "nullable": true,
+            "example": "0.154"
+          },
+          "one_month_ago": {
+            "description": "Price from one month ago\n\nThe price from approximately 30 days prior to the current time.",
+            "format": "decimal",
+            "type": "string",
+            "nullable": true,
+            "example": "0.154"
+          },
+          "one_week_ago": {
+            "description": "Price from one week ago\n\nThe price from 7 days prior to the current time.",
+            "format": "decimal",
+            "type": "string",
+            "nullable": true,
+            "example": "0.154"
+          },
+          "one_year_ago": {
+            "description": "Price from one year ago\n\nThe price from 365 days prior to the current time.",
+            "format": "decimal",
+            "type": "string",
+            "nullable": true,
+            "example": "0.154"
+          },
+          "start_of_day": {
+            "description": "Price at the start of the current day\n\nRepresents the price at the beginning of the current day (00:00:00 UTC), useful for calculating daily price changes.",
+            "format": "decimal",
+            "type": "string",
+            "nullable": true,
+            "example": "0.154"
+          }
+        },
+        "type": "object"
+      },
+      "Coin": {
+        "enum": [
+          "CC",
+          "CBTC",
+          "USDCx"
+        ],
+        "type": "string"
+      },
+      "CoinEnum": {
+        "enum": [
+          "CC",
+          "CBTC",
+          "USDCx"
+        ],
+        "type": "string"
+      },
+      "CoinTransfersFromNodeQuery": {
+        "description": "Query parameters accepted by the node for party standard coin transfers.",
+        "not": {}
+      },
+      "CoinTransfersFromNodeRequest": {
+        "additionalProperties": false,
+        "properties": {
+          "network": {
+            "$ref": "#/definitions/CANTON_NETWORK_VARIANTS"
+          }
+        },
+        "required": [
+          "network"
+        ],
+        "type": "object"
+      },
+      "CoinTransfersFromNodeResponse": {
+        "anyOf": [
+          {
+            "$ref": "#/definitions/GetTransfersHistoryResponseDTO"
+          },
+          {
+            "nullable": true
+          }
+        ],
+        "description": "Paged standard coin transfer summaries or null if no data exists."
+      },
+      "CombinedCursor": {
+        "description": "CombinedCursor CombinedCursor format: `{datetime},{id}`.\n- `datetime`: ISO-8601 timestamp with UTC timezone (e.g., 2025-10-28T10:15:00.000000Z)\n- `id`: **optional** uint64, unique index or sequence number\n\nExamples:\n- With ID: \"2025-10-28T10:15:00.000000Z,123\"\n- Without ID: \"2025-10-28T10:15:00.000000Z\"",
+        "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?Z(?:,\\d+)?$",
+        "type": "string",
+        "example": "2025-10-28T10:15:00.000000Z,123"
+      },
+      "CommonDataFieldsRequest": {
+        "additionalProperties": false,
+        "description": "Common fields included in every request message posted to the wallet.\n\nFields:\n- `type`: The message type, one of PUBLIC_REQUESTS.\n- `target`: Target identifier to scope messages to the wallet.\n- `id`: Correlation ID used to match responses.",
+        "properties": {
+          "fromOrigin": {
+            "type": "string"
+          },
+          "id": {
+            "type": "string"
+          },
+          "sdkVersion": {
+            "type": "string"
+          },
+          "target": {
+            "type": "string"
+          },
+          "type": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "type",
+          "target",
+          "id",
+          "fromOrigin"
+        ],
+        "type": "object"
+      },
+      "CommonDataFieldsTrigger": {
+        "additionalProperties": false,
+        "properties": {
+          "forOrigin": {
+            "description": "Optional origin the trigger is intended for; used by the wallet.",
+            "type": "string"
+          },
+          "fromOrigin": {
+            "type": "string"
+          },
+          "id": {
+            "type": "string"
+          },
+          "sdkVersion": {
+            "type": "string"
+          },
+          "target": {
+            "type": "string"
+          },
+          "type": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "fromOrigin",
+          "id",
+          "target",
+          "type"
+        ],
+        "type": "object"
+      },
+      "ConnectRequest": {
+        "additionalProperties": false,
+        "description": "Optional metadata provided by a dApp when initiating a connection. Used by the wallet UI to present context to the user.",
+        "properties": {
+          "icon": {
+            "type": "string"
+          },
+          "name": {
+            "type": "string"
+          },
+          "target": {
+            "$ref": "#/definitions/ConnectVariant"
+          }
+        },
+        "type": "object"
+      },
+      "ConnectRequestInternal": {
+        "additionalProperties": false,
+        "description": "Internal-only fields included by the wallet during connection flow. Not provided by the dApp.",
+        "properties": {
+          "referer": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "referer"
+        ],
+        "type": "object"
+      },
+      "ConnectResponse": {
+        "additionalProperties": false,
+        "description": "Response for connect/status queries; mirrors `ConnectStatus`.",
+        "properties": {
+          "isConnected": {
+            "type": "boolean"
+          },
+          "isNetworkConnected": {
+            "type": "boolean"
+          },
+          "networkReason": {
+            "type": "string"
+          },
+          "reason": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "isConnected"
+        ],
+        "type": "object"
+      },
+      "ConnectResponseLegacy": {
+        "description": "Connection status reported by the wallet for the dApp origin.",
+        "enum": [
+          "connected",
+          "disconnected"
+        ],
+        "type": "string"
+      },
+      "ConnectResult": {
+        "$ref": "#/definitions/ConnectResponse",
+        "description": "Response for connect/status queries; mirrors `ConnectStatus`."
+      },
+      "ConnectStatus": {
+        "description": "Connection status reported by the wallet for the dApp origin.",
+        "type": "boolean"
+      },
+      "ConnectVariant": {
+        "description": "Connection variant. \"local\" for only extension connection, \"remote\" for only remote connection (mobile app), \"combined\" for both extension and remote connection. default: \"combined\"",
+        "enum": [
+          "local",
+          "remote",
+          "combined"
+        ],
+        "type": "string"
+      },
+      "ConsoleWalletError": {
+        "$ref": "#/definitions/ProviderRpcError"
+      },
+      "ContractId": {
+        "description": "ContractId Daml contract ID encoded as a 138-character lowercase hexadecimal string",
+        "format": "byte",
+        "pattern": "^00[a-f0-9]{136}$",
+        "type": "string",
+        "example": "001dbd4eac6d06371a1dc850d3cc3d1039688403fe2f9ab98985e8e8d0701f211fca111220b859db866c3cf320cf3dda548cca9a43d7770b6a5a5937a926b771a222674385"
+      },
+      "DisconnectResponse": {
+        "description": "Response for disconnect",
+        "nullable": true
+      },
+      "EIP_1474_ERROR_ENUM": {
+        "enum": [
+          0,
+          1,
+          2,
+          3,
+          4,
+          5,
+          6,
+          7,
+          8,
+          9,
+          10,
+          11,
+          12,
+          13,
+          14,
+          15
+        ],
+        "type": "number"
+      },
+      "ElementType<structure-1531355553-79543-81974-1531355553-79543-81976-1531355553-79535-81977-1531355553-79492-82075-1531355553-0-347510[]>": {
+        "additionalProperties": false,
+        "description": "Element type of an array; resolves `U` from `T extends U[]`.",
+        "properties": {
+          "amount": {
+            "description": "The amount of tokens to be transferred. Expressed in the base unit with full precision (e.g., 10.0 = 10 tokens).",
+            "format": "decimal",
+            "type": "string",
+            "example": "10.00000"
+          },
+          "contract_id": {
+            "anyOf": [
+              {
+                "nullable": true
+              },
+              {
+                "$ref": "#/definitions/ContractId"
+              }
+            ],
+            "description": "The Daml contract ID representing this offer. Used to reference and exercise choices on the contract."
+          },
+          "event_id": {
+            "$ref": "#/definitions/EventId",
+            "description": "Unique identifier of the Daml event that created this offer. Used to track the creation event in the transaction log."
+          },
+          "external_cc_price": {
+            "description": "External market Canton-coin (CC) price in USD.\n\nThis price is sourced from external markets (e.g., exchanges) and reflects the current market value of CC.\n\nAvailable **only on mainnet**, where external price feeds are integrated. It can be used for reporting, analysis, or comparison against the internal price.",
+            "type": "string",
+            "nullable": true
+          },
+          "internal_cc_price": {
+            "description": "Internal Canton-coin (CC) price in USD.\n\nThis is the price approved by the committee via voting and used internally for calculations, valuations, and offer execution logic. It is always present and serves as the canonical internal valuation of CC.\n\nThe field not valid for /api/v1/offers/search. Use /api/v2/offers/search",
+            "type": "string"
+          },
+          "offer_type": {
+            "$ref": "#/definitions/OfferType",
+            "description": "Exact type of the offer."
+          },
+          "provider_party_id": {
+            "$ref": "#/definitions/PartyId",
+            "description": "The party identifier of the offer provider.\n\nThis is the party who is providing the offer creation."
+          },
+          "receiver_party_id": {
+            "$ref": "#/definitions/PartyId",
+            "description": "The intended recipient of the transfer (receiver in the first leg). May differ from final recipient if conditional logic applies."
+          },
+          "record_time": {
+            "description": "Assigned by the Canton domain, this reflects when the transaction was sequenced. Format: ISO 8601 Example: `\"2025-04-05T10:00:00Z\"`",
+            "format": "date-time",
+            "type": "string"
+          },
+          "sender_party_id": {
+            "$ref": "#/definitions/PartyId",
+            "description": "The party initiating the transfer (sender of the first leg). This is the original owner of the tokens being transferred."
+          },
+          "status": {
+            "$ref": "#/definitions/OfferStatus",
+            "description": "The current status of the offer (e.g., pending, executed, failed). Reflects the state of the Daml contract and whether transfers have been completed."
+          }
+        },
+        "required": [
+          "amount",
+          "event_id",
+          "internal_cc_price",
+          "offer_type",
+          "provider_party_id",
+          "receiver_party_id",
+          "record_time",
+          "sender_party_id",
+          "status"
+        ],
+        "type": "object"
+      },
+      "EventId": {
+        "description": "eventId Daml event ID format: `update_id:number`.\n- `update_id`: 64-character hexadecimal string\n- `number`: **uint64**, event index within the update",
+        "format": "update_id:number",
+        "pattern": "^1220[a-f0-9]{64}:\\d+$",
+        "type": "string",
+        "example": "1220f66d301e0049af910c57e04f87697d0377c6086290bf8d6f89a64fad54ad7de3:46"
+      },
+      "ExternalTxId": {
+        "description": "Unique identifier of the signed transaction given by the Signing Provider. This may not be the same as the internal txId given by the Wallet Gateway.",
+        "type": "string"
+      },
+      "GetAccountResponse": {
+        "anyOf": [
+          {
+            "$ref": "#/definitions/Wallet"
+          },
+          {
+            "not": {}
+          }
+        ],
+        "description": "Single account or undefined when no active account is set."
+      },
+      "GetAccountsResponse": {
+        "anyOf": [
+          {
+            "items": {
+              "$ref": "#/definitions/Wallet"
+            },
+            "type": "array"
+          },
+          {
+            "not": {}
+          }
+        ],
+        "description": "Array of accounts or undefined when no accounts are available."
+      },
+      "GetBalanceRequest": {
+        "additionalProperties": false,
+        "description": "Party/network pair used to request balances from the wallet/indexer.",
+        "properties": {
+          "network": {
+            "$ref": "#/definitions/CANTON_NETWORK_VARIANTS"
+          },
+          "party": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "party",
+          "network"
+        ],
+        "type": "object"
+      },
+      "GetBalanceResponse": {
+        "additionalProperties": false,
+        "description": "Token list, split-balance flag (multi-network party), and aggregated price.",
+        "properties": {
+          "isSplitedBalance": {
+            "type": "boolean"
+          },
+          "price": {
+            "type": "string"
+          },
+          "tokens": {
+            "items": {
+              "$ref": "#/definitions/TokenData"
+            },
+            "type": "array"
+          }
+        },
+        "required": [
+          "tokens",
+          "isSplitedBalance",
+          "price"
+        ],
+        "type": "object"
+      },
+      "GetCoinsResponse": {
+        "additionalProperties": false,
+        "properties": {
+          "prices": {
+            "anyOf": [
+              {
+                "additionalProperties": false,
+                "properties": {
+                  "CBTC": {
+                    "$ref": "#/definitions/CCPrices"
+                  },
+                  "CC": {
+                    "$ref": "#/definitions/CCPrices"
+                  },
+                  "USDCx": {
+                    "$ref": "#/definitions/CCPrices"
+                  }
+                },
+                "type": "object"
+              },
+              {
+                "nullable": true
+              }
+            ]
+          },
+          "tokens": {
+            "items": {
+              "$ref": "#/definitions/TokenData"
+            },
+            "type": "array"
+          }
+        },
+        "required": [
+          "tokens",
+          "prices"
+        ],
+        "type": "object"
+      },
+      "GetPendingTransactionsResponseDTO": {
+        "additionalProperties": false,
+        "properties": {
+          "items": {
+            "items": {
+              "$ref": "#/definitions/PendingTransfersResponseDTO"
+            },
+            "type": "array"
+          },
+          "totalAmount": {
+            "type": "number"
+          }
+        },
+        "required": [
+          "items",
+          "totalAmount"
+        ],
+        "type": "object"
+      },
+      "GetTransfersHistoryResponseDTO": {
+        "additionalProperties": false,
+        "properties": {
+          "items": {
+            "items": {
+              "$ref": "#/definitions/TransferResponseDTO"
+            },
+            "type": "array"
+          },
+          "totalAmount": {
+            "type": "number"
+          }
+        },
+        "required": [
+          "items",
+          "totalAmount"
+        ],
+        "type": "object"
+      },
+      "HexMessage": {
+        "additionalProperties": false,
+        "description": "Message body encoded as a hexadecimal string.",
+        "properties": {
+          "hex": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "hex"
+        ],
+        "type": "object"
+      },
+      "Hint": {
+        "description": "The party hint and name of the wallet.",
+        "type": "string"
+      },
+      "INTERNAL_REQUESTS": {
+        "description": "Internal message types used for extension background/offscreen communication. Not exposed to dApps directly.",
+        "enum": [
+          "SAVE_SESSION_DATA",
+          "GET_SESSION_DATA",
+          "RESET_SESSION_DATA",
+          "SET_PAGE_DATA",
+          "GET_PAGE_DATA",
+          "RESET_PAGE_DATA"
+        ],
+        "type": "string"
+      },
+      "LedgerApiRequest": {
+        "additionalProperties": false,
+        "properties": {
+          "body": {
+            "description": "A serialized body for POST / PUT requests",
+            "type": "string"
+          },
+          "network": {
+            "$ref": "#/definitions/CANTON_NETWORK_VARIANTS"
+          },
+          "requestMethod": {
+            "description": "A method to send request to",
+            "type": "string",
+            "enum": [
+              "GET"
+            ],
+            "example": "GET"
+          },
+          "resource": {
+            "description": "A url resource to call via sdk",
+            "type": "string",
+            "example": "/v2/version"
+          }
+        },
+        "required": [
+          "body",
+          "network",
+          "requestMethod",
+          "resource"
+        ],
+        "type": "object"
+      },
+      "LedgerApiResponse": {
+        "$ref": "#/definitions/SdkLedgerProxyResponseDTO"
+      },
+      "Namespace": {
+        "description": "The namespace of the party.",
+        "type": "string"
+      },
+      "Network": {
+        "additionalProperties": false,
+        "description": "Network metadata for display and routing to indexer/backends.",
+        "properties": {
+          "accessToken": {
+            "type": "string"
+          },
+          "baseUrl": {
+            "type": "string"
+          },
+          "description": {
+            "type": "string"
+          },
+          "explorerUrl": {
+            "type": "string"
+          },
+          "icon": {
+            "type": "string"
+          },
+          "id": {
+            "$ref": "#/definitions/CANTON_NETWORK_VARIANTS"
+          },
+          "identityProviderId": {
+            "type": "string"
+          },
+          "ledgerApi": {
+            "type": "string"
+          },
+          "name": {
+            "type": "string"
+          },
+          "nativeTokenId": {
+            "description": "Token ID used as the network's native currency reference.",
+            "type": "string"
+          },
+          "networkId": {
+            "$ref": "#/definitions/CAIP2_CANTON_NETWORKS"
+          },
+          "shortName": {
+            "type": "string"
+          },
+          "synchronizerId": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "id",
+          "networkId",
+          "name",
+          "description",
+          "identityProviderId",
+          "baseUrl",
+          "nativeTokenId"
+        ],
+        "type": "object"
+      },
+      "NetworkStatus": {
+        "description": "Boolean alias indicating whether the network available",
+        "type": "boolean"
+      },
+      "OfferStatus": {
+        "default": "pending",
+        "description": "Status of an Offer. One of: pending, completed, rejected, withdrawn, expire, failed.",
+        "enum": [
+          "pending",
+          "completed",
+          "rejected",
+          "withdrawn",
+          "failed",
+          "expire"
+        ],
+        "type": "string",
+        "example": "pending"
+      },
+      "OfferType": {
+        "default": "allocation",
+        "description": "Type of an Offer. One of: allocation, instruction, command.",
+        "enum": [
+          "allocation",
+          "instruction",
+          "command"
+        ],
+        "type": "string",
+        "example": "allocation"
+      },
+      "OffersFromNodeQuery": {
+        "description": "Query parameters accepted by the indexer for offers by sender.",
+        "not": {}
+      },
+      "OffersFromNodeRequest": {
+        "additionalProperties": false,
+        "properties": {
+          "network": {
+            "$ref": "#/definitions/CANTON_NETWORK_VARIANTS"
+          }
+        },
+        "required": [
+          "network"
+        ],
+        "type": "object"
+      },
+      "OffersFromNodeResponse": {
+        "anyOf": [
+          {
+            "$ref": "#/definitions/GetPendingTransactionsResponseDTO"
+          },
+          {
+            "nullable": true
+          }
+        ],
+        "description": "Paged offers response or null if no data exists."
+      },
+      "OffersQuery": {
+        "description": "Query parameters accepted by the indexer for offers by sender.",
+        "not": {}
+      },
+      "OffersRequest": {
+        "additionalProperties": false,
+        "properties": {
+          "network": {
+            "$ref": "#/definitions/CANTON_NETWORK_VARIANTS"
+          }
+        },
+        "required": [
+          "network"
+        ],
+        "type": "object"
+      },
+      "OffersResponse": {
+        "anyOf": [
+          {
+            "$ref": "#/definitions/PagedByCombinedCursorResponseOffer"
+          },
+          {
+            "nullable": true
+          }
+        ],
+        "description": "Paged offers response or null if no data exists."
+      },
+      "OutputTimeLock": {
+        "additionalProperties": false,
+        "description": "DTO representing a time lock condition on a transaction output.\n\nA time lock restricts spending of funds until certain conditions are met, such as a specific time or involvement of specific parties. This is often used for escrow, vesting, or delayed transfers.",
+        "properties": {
+          "context": {
+            "type": "string",
+            "nullable": true,
+            "example": "transfer to 'dev_test::122035334a67f4de9d2aecdd5b83485cbaee20682e3f0491bdf12b0a32d81cc93c90'"
+          },
+          "expires_at": {
+            "description": "The UTC timestamp after which the output can be spent.\n\nBefore this time, the output is locked and cannot be consumed in a transaction. Expressed in ISO 8601 format.\n\nExample: `\"2025-12-31T23:59:59Z\"`",
+            "format": "date-time",
+            "type": "string",
+            "example": "2025-12-31T23:59:59Z"
+          },
+          "holders": {
+            "description": "The list of parties (holders) who are authorized to spend this output once the lock expires.\n\nAll listed parties must agree (depending on script logic) to unlock and spend the funds. Used to enforce multi-party control over locked assets.",
+            "items": {
+              "$ref": "#/definitions/PartyId"
+            },
+            "type": "array",
+            "example": [
+              "DSO::1220be58c29e65de40bf273be1dc2b266d43a9a002ea5b18955aeef7aac881bb471a",
+              "alice::1220c7c1e52f96fe1b7165f890cdcf90991691e7555a7f0ca173757208f5c57541c4"
+            ]
+          }
+        },
+        "required": [
+          "expires_at",
+          "holders"
+        ],
+        "type": "object"
+      },
+      "POSSIBLE_RESPONSE_TYPE": {
+        "description": "Template-literal form for deriving a `${REQUEST}_RESPONSE` message type.",
+        "enum": [
+          "GET_IS_CONNECTED_NETWORK_RESPONSE",
+          "CONNECT_RESPONSE",
+          "DISCONNECT_RESPONSE",
+          "GET_IS_CONNECTED_RESPONSE",
+          "GET_VERSION_RESPONSE",
+          "GET_ACTIVE_NETWORK_RESPONSE",
+          "SIGN_MESSAGE_RESPONSE",
+          "SIGN_SEND_RESPONSE",
+          "SIGN_BATCH_RESPONSE",
+          "SIGN_INSTRUCTION_CHOICE_RESPONSE",
+          "GET_ACCOUNTS_RESPONSE",
+          "GET_ACTIVE_ACCOUNT_RESPONSE",
+          "GET_BALANCE_RESPONSE",
+          "GET_COINS_BALANCE_RESPONSE",
+          "GET_TRANSFERS_HISTORY_RESPONSE",
+          "GET_TRANSFER_DETAILS_RESPONSE",
+          "GET_OFFERS_HISTORY_RESPONSE",
+          "GET_NODE_TRANSFERS_HISTORY_RESPONSE",
+          "GET_NODE_TRANSFER_DETAILS_RESPONSE",
+          "GET_NODE_OFFERS_HISTORY_RESPONSE",
+          "LEDGER_API_RESPONSE"
+        ],
+        "type": "string"
+      },
+      "POSSIBLE_TRIGGER_TYPE": {
+        "description": "Template-literal form for deriving a `${REQUEST}_TRIGGER` message type.",
+        "enum": [
+          "GET_IS_CONNECTED_NETWORK_TRIGGER",
+          "CONNECT_TRIGGER",
+          "DISCONNECT_TRIGGER",
+          "GET_IS_CONNECTED_TRIGGER",
+          "GET_VERSION_TRIGGER",
+          "GET_ACTIVE_NETWORK_TRIGGER",
+          "SIGN_MESSAGE_TRIGGER",
+          "SIGN_SEND_TRIGGER",
+          "SIGN_BATCH_TRIGGER",
+          "SIGN_INSTRUCTION_CHOICE_TRIGGER",
+          "GET_ACCOUNTS_TRIGGER",
+          "GET_ACTIVE_ACCOUNT_TRIGGER",
+          "GET_BALANCE_TRIGGER",
+          "GET_COINS_BALANCE_TRIGGER",
+          "GET_TRANSFERS_HISTORY_TRIGGER",
+          "GET_TRANSFER_DETAILS_TRIGGER",
+          "GET_OFFERS_HISTORY_TRIGGER",
+          "GET_NODE_TRANSFERS_HISTORY_TRIGGER",
+          "GET_NODE_TRANSFER_DETAILS_TRIGGER",
+          "GET_NODE_OFFERS_HISTORY_TRIGGER",
+          "LEDGER_API_TRIGGER"
+        ],
+        "type": "string"
+      },
+      "PUBLIC_REQUESTS": {
+        "description": "Public request types that a dApp can post to the wallet. Each request has a corresponding `${REQUEST}_RESPONSE` message.",
+        "enum": [
+          "GET_IS_CONNECTED_NETWORK",
+          "CONNECT",
+          "DISCONNECT",
+          "GET_IS_CONNECTED",
+          "GET_VERSION",
+          "GET_ACTIVE_NETWORK",
+          "SIGN_MESSAGE",
+          "SIGN_SEND",
+          "SIGN_BATCH",
+          "SIGN_INSTRUCTION_CHOICE",
+          "GET_ACCOUNTS",
+          "GET_ACTIVE_ACCOUNT",
+          "GET_BALANCE",
+          "GET_COINS_BALANCE",
+          "GET_TRANSFERS_HISTORY",
+          "GET_TRANSFER_DETAILS",
+          "GET_OFFERS_HISTORY",
+          "GET_NODE_TRANSFERS_HISTORY",
+          "GET_NODE_TRANSFER_DETAILS",
+          "GET_NODE_OFFERS_HISTORY",
+          "LEDGER_API"
+        ],
+        "type": "string"
+      },
+      "PagedByCombinedCursorResponseOffer": {
+        "additionalProperties": false,
+        "properties": {
+          "data": {
+            "description": "The list of items (records) retrieved for the current page.",
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "amount": {
+                  "description": "The amount of tokens to be transferred. Expressed in the base unit with full precision (e.g., 10.0 = 10 tokens).",
+                  "format": "decimal",
+                  "type": "string",
+                  "example": "10.00000"
+                },
+                "contract_id": {
+                  "anyOf": [
+                    {
+                      "nullable": true
+                    },
+                    {
+                      "$ref": "#/definitions/ContractId"
+                    }
+                  ],
+                  "description": "The Daml contract ID representing this offer. Used to reference and exercise choices on the contract."
+                },
+                "event_id": {
+                  "$ref": "#/definitions/EventId",
+                  "description": "Unique identifier of the Daml event that created this offer. Used to track the creation event in the transaction log."
+                },
+                "external_cc_price": {
+                  "description": "External market Canton-coin (CC) price in USD.\n\nThis price is sourced from external markets (e.g., exchanges) and reflects the current market value of CC.\n\nAvailable **only on mainnet**, where external price feeds are integrated. It can be used for reporting, analysis, or comparison against the internal price.",
+                  "type": "string",
+                  "nullable": true
+                },
+                "internal_cc_price": {
+                  "description": "Internal Canton-coin (CC) price in USD.\n\nThis is the price approved by the committee via voting and used internally for calculations, valuations, and offer execution logic. It is always present and serves as the canonical internal valuation of CC.\n\nThe field not valid for /api/v1/offers/search. Use /api/v2/offers/search",
+                  "type": "string"
+                },
+                "offer_type": {
+                  "$ref": "#/definitions/OfferType",
+                  "description": "Exact type of the offer."
+                },
+                "provider_party_id": {
+                  "$ref": "#/definitions/PartyId",
+                  "description": "The party identifier of the offer provider.\n\nThis is the party who is providing the offer creation."
+                },
+                "receiver_party_id": {
+                  "$ref": "#/definitions/PartyId",
+                  "description": "The intended recipient of the transfer (receiver in the first leg). May differ from final recipient if conditional logic applies."
+                },
+                "record_time": {
+                  "description": "Assigned by the Canton domain, this reflects when the transaction was sequenced. Format: ISO 8601 Example: `\"2025-04-05T10:00:00Z\"`",
+                  "format": "date-time",
+                  "type": "string"
+                },
+                "sender_party_id": {
+                  "$ref": "#/definitions/PartyId",
+                  "description": "The party initiating the transfer (sender of the first leg). This is the original owner of the tokens being transferred."
+                },
+                "status": {
+                  "$ref": "#/definitions/OfferStatus",
+                  "description": "The current status of the offer (e.g., pending, executed, failed). Reflects the state of the Daml contract and whether transfers have been completed."
+                }
+              },
+              "required": [
+                "amount",
+                "event_id",
+                "internal_cc_price",
+                "offer_type",
+                "provider_party_id",
+                "receiver_party_id",
+                "record_time",
+                "sender_party_id",
+                "status"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "next_cursor": {
+            "anyOf": [
+              {
+                "nullable": true
+              },
+              {
+                "$ref": "#/definitions/CombinedCursor"
+              }
+            ],
+            "description": "An optional cursor used for fetching the next page of results. This field is omitted from serialization if its value is `None`."
+          }
+        },
+        "required": [
+          "data"
+        ],
+        "type": "object"
+      },
+      "PagedByCombinedCursorResponseTokenTransferSummary": {
+        "additionalProperties": false,
+        "properties": {
+          "data": {
+            "description": "The list of items (records) retrieved for the current page.",
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "event_id": {
+                  "description": "eventId Daml event ID format: `update_id:number`.\n- `update_id`: 64-character hexadecimal string\n- `number`: **uint64**, event index within the update",
+                  "format": "update_id:number",
+                  "pattern": "^1220[a-f0-9]{64}:\\d+$",
+                  "type": "string",
+                  "example": "1220f66d301e0049af910c57e04f87697d0377c6086290bf8d6f89a64fad54ad7de3:46"
+                },
+                "record_time": {
+                  "format": "date-time",
+                  "type": "string"
+                },
+                "spent": {
+                  "$ref": "#/definitions/Spent",
+                  "description": "Detailed breakdown of token expenditure, including all fees and amounts received by counterparties. Provides a comprehensive summary of all outgoing value flows, including:\n- Fees paid to the network\n- Gross amount debited from sender's balance\n- Individual receiver allocations with net amounts"
+                },
+                "transfer_data": {
+                  "$ref": "#/definitions/TransferData",
+                  "description": "Original content of transfer data."
+                },
+                "transfer_type": {
+                  "$ref": "#/definitions/TokenTransferType",
+                  "description": "Type of transfer."
+                },
+                "update_id": {
+                  "description": "UpdateId Daml update ID in **multihash** format.\n- Begins with `1220` (indicating SHA-256 hash, 32-byte digest)\n- Followed by 64 lowercase hexadecimal characters\n- Total length: 68 characters This format ensures global uniqueness and cryptographic integrity in Canton.",
+                  "format": "byte",
+                  "pattern": "^1220[a-f0-9]{64}$",
+                  "type": "string",
+                  "example": "122050503ac262ae61001e430f2ba3ff9b1854b74f78a1a1da1f8f9948640088591f"
+                }
+              },
+              "required": [
+                "event_id",
+                "record_time",
+                "spent",
+                "transfer_data",
+                "transfer_type",
+                "update_id"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "next_cursor": {
+            "anyOf": [
+              {
+                "nullable": true
+              },
+              {
+                "$ref": "#/definitions/CombinedCursor"
+              }
+            ],
+            "description": "An optional cursor used for fetching the next page of results. This field is omitted from serialization if its value is `None`."
+          }
+        },
+        "required": [
+          "data"
+        ],
+        "type": "object"
+      },
+      "PartyId": {
+        "description": "Template-literal type representing a party identifier ([a-zA-Z0-9:_-]*::[a-z0-9]) with namespace matching the pattern . Example: \"partHint::generatedPart\".",
+        "type": "string"
+      },
+      "PendingTransfersResponseDTO": {
+        "additionalProperties": false,
+        "properties": {
+          "amount": {
+            "type": "string"
+          },
+          "coin": {
+            "enum": [
+              "CC",
+              "CBTC",
+              "USDCx"
+            ],
+            "type": "string"
+          },
+          "createdAt": {
+            "format": "date-time",
+            "type": "string"
+          },
+          "expiredAt": {
+            "format": "date-time",
+            "type": "string"
+          },
+          "receiver": {
+            "type": "string"
+          },
+          "sender": {
+            "type": "string"
+          },
+          "status": {
+            "enum": [
+              "Pending",
+              "SUCCESSFUL",
+              "FAILED",
+              "Accepted",
+              "Rejected"
+            ],
+            "type": "string"
+          },
+          "transferCid": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "amount",
+          "coin",
+          "createdAt",
+          "expiredAt",
+          "receiver",
+          "sender",
+          "status",
+          "transferCid"
+        ],
+        "type": "object"
+      },
+      "Primary": {
+        "description": "Set as primary wallet for dApp usage.",
+        "type": "boolean"
+      },
+      "Provider": {
+        "additionalProperties": false,
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "providerType": {
+            "$ref": "#/definitions/ProviderTypeEnum"
+          },
+          "version": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "id",
+          "version",
+          "providerType"
+        ],
+        "type": "object"
+      },
+      "ProviderNetwork": {
+        "additionalProperties": false,
+        "properties": {
+          "accessToken": {
+            "type": "string"
+          },
+          "ledgerApi": {
+            "type": "string"
+          },
+          "networkId": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "networkId"
+        ],
+        "type": "object"
+      },
+      "ProviderRpcError": {
+        "additionalProperties": false,
+        "properties": {
+          "code": {
+            "type": "number"
+          },
+          "data": {},
+          "message": {
+            "type": "string"
+          },
+          "name": {
+            "type": "string"
+          },
+          "stack": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "code",
+          "message",
+          "name"
+        ],
+        "type": "object"
+      },
+      "ProviderTypeEnum": {
+        "enum": [
+          "browser",
+          "desktop",
+          "mobile",
+          "remote"
+        ],
+        "type": "string"
+      },
+      "PublicKey": {
+        "description": "The public key of the party.",
+        "type": "string"
+      },
+      "Received": {
+        "additionalProperties": false,
+        "description": "Represents income amount of a certain Party.",
+        "properties": {
+          "amount": {
+            "description": "Net amount received by this party after all fees and allocations.\n\nRepresented as a decimal string to avoid floating-point precision issues.",
+            "format": "decimal",
+            "type": "string",
+            "example": "49.92"
+          },
+          "receiver": {
+            "$ref": "#/definitions/PartyId",
+            "description": "Unique Canton party identifier of receiver  (e.g., `\"Alice::123...\"`)"
+          }
+        },
+        "required": [
+          "amount",
+          "receiver"
+        ],
+        "type": "object"
+      },
+      "SdkLedgerProxyResponseDTO": {
+        "additionalProperties": false,
+        "properties": {
+          "response": {
+            "description": "A serialized response",
+            "type": "string"
+          }
+        },
+        "required": [
+          "response"
+        ],
+        "type": "object"
+      },
+      "SendConfirmationDataType": {
+        "$ref": "#/definitions/ElementType%3Cstructure-1531355553-79543-81974-1531355553-79543-81976-1531355553-79535-81977-1531355553-79492-82075-1531355553-0-347510%5B%5D%3E",
+        "description": "Element type of the confirmation data returned by the indexer wait function."
+      },
+      "SendType": {
+        "description": "Specifies the type of token transfer being initiated.",
+        "enum": [
+          "OFFER",
+          "DIRECT_TRANSFER"
+        ],
+        "type": "string"
+      },
+      "Session": {
+        "additionalProperties": false,
+        "properties": {
+          "accessToken": {
+            "type": "string"
+          },
+          "userId": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "accessToken",
+          "userId"
+        ],
+        "type": "object"
+      },
+      "SignBatchRequest": {
+        "anyOf": [
+          {
+            "$ref": "#/definitions/BatchSend"
+          },
+          {
+            "$ref": "#/definitions/BatchUnknown"
+          }
+        ],
+        "description": "Union type representing a batch request for signing."
+      },
+      "SignBatchResponse": {
+        "anyOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "signature": {
+                "type": "string"
+              },
+              "status": {
+                "enum": [
+                  true,
+                  false
+                ],
+                "type": "boolean"
+              }
+            },
+            "required": [
+              "status"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": false,
+            "properties": {
+              "signatures": {
+                "items": {
+                  "type": "string"
+                },
+                "type": "array"
+              },
+              "status": {
+                "enum": [
+                  true,
+                  false
+                ],
+                "type": "boolean"
+              }
+            },
+            "required": [
+              "status",
+              "signatures"
+            ],
+            "type": "object"
+          },
+          {
+            "not": {}
+          }
+        ],
+        "description": "Result of the sign batch operation."
+      },
+      "SignInstructionChoiceRequest": {
+        "additionalProperties": false,
+        "description": "Request to interact with a token transfer instruction",
+        "properties": {
+          "choice": {
+            "$ref": "#/definitions/TransactionInstructionChoice"
+          },
+          "coin": {
+            "$ref": "#/definitions/CoinEnum"
+          },
+          "instructionData": {
+            "$ref": "#/definitions/PendingTransfersResponseDTO"
+          },
+          "transferCid": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "transferCid",
+          "coin",
+          "choice",
+          "instructionData"
+        ],
+        "type": "object"
+      },
+      "SignInstructionChoiceResponse": {
+        "anyOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "signature": {
+                "type": "string"
+              },
+              "status": {
+                "enum": [
+                  true,
+                  false
+                ],
+                "type": "boolean"
+              }
+            },
+            "required": [
+              "status"
+            ],
+            "type": "object"
+          },
+          {
+            "not": {}
+          }
+        ],
+        "description": "Result of the instruction choice operation"
+      },
+      "SignMessageRequest": {
+        "additionalProperties": false,
+        "description": "Request to sign a message; provide either a hex or base64 payload.",
+        "properties": {
+          "message": {
+            "anyOf": [
+              {
+                "$ref": "#/definitions/HexMessage"
+              },
+              {
+                "$ref": "#/definitions/Base64Message"
+              }
+            ]
+          },
+          "metaData": {
+            "additionalProperties": {
+              "type": "string"
+            },
+            "type": "object"
+          }
+        },
+        "required": [
+          "message"
+        ],
+        "type": "object"
+      },
+      "SignSendRequest": {
+        "additionalProperties": false,
+        "description": "Request to sign and send a token transfer.",
+        "properties": {
+          "amount": {
+            "type": "string"
+          },
+          "expireDate": {
+            "type": "string"
+          },
+          "from": {
+            "type": "string"
+          },
+          "memo": {
+            "type": "string"
+          },
+          "to": {
+            "type": "string"
+          },
+          "token": {
+            "$ref": "#/definitions/CoinEnum"
+          },
+          "waitForFinalization": {
+            "description": "Optional wait time in milliseconds for finalization; must be between MIN_WAITING and MAX_WAITING.",
+            "type": "number"
+          }
+        },
+        "required": [
+          "amount",
+          "expireDate",
+          "from",
+          "to",
+          "token"
+        ],
+        "type": "object"
+      },
+      "SignSendRequestRequiredFields": {
+        "additionalProperties": false,
+        "description": "Required fields for a sign-and-send token transfer request.",
+        "properties": {
+          "amount": {
+            "type": "string"
+          },
+          "expireDate": {
+            "type": "string"
+          },
+          "from": {
+            "type": "string"
+          },
+          "memo": {
+            "type": "string"
+          },
+          "to": {
+            "type": "string"
+          },
+          "token": {
+            "$ref": "#/definitions/CoinEnum"
+          }
+        },
+        "required": [
+          "from",
+          "to",
+          "token",
+          "amount",
+          "expireDate"
+        ],
+        "type": "object"
+      },
+      "SignSendResponse": {
+        "anyOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "confirmationData": {
+                "$ref": "#/definitions/SendConfirmationDataType",
+                "description": "Present when `waitForFinalization` is set and the indexer returns data."
+              },
+              "signature": {
+                "type": "string"
+              },
+              "status": {
+                "enum": [
+                  true,
+                  false
+                ],
+                "type": "boolean"
+              }
+            },
+            "required": [
+              "status"
+            ],
+            "type": "object"
+          },
+          {
+            "not": {}
+          }
+        ],
+        "description": "Result of the sign-and-send operation, including optional confirmation data."
+      },
+      "SignedMessageResponse": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "not": {}
+          }
+        ],
+        "description": "Result payload returned after signing an arbitrary message."
+      },
+      "SigningProviderId": {
+        "description": "The signing provider ID the wallet corresponds to.",
+        "type": "string"
+      },
+      "Spent": {
+        "additionalProperties": false,
+        "description": "Represents the summary of token expenditure and fee distribution for a sender in a Canton network token transfer.\n\nThis struct aggregates all outgoing value flows from the sender's perspective, including fees paid to the network, change returned (if any), and amounts received by counterparties. It is typically used in settlement summaries, audit trails, or user-facing transfer breakdowns within a Canton-based DLT (Distributed Ledger Technology) environment.",
+        "properties": {
+          "external_cc_price": {
+            "description": "External market Canton-coin (CC) price in USD.\n\nThis price is sourced from external markets (e.g., exchanges) and reflects the current market value of CC. Available only on mainnet. Can be used for reporting, analysis, or comparison against internal price.",
+            "type": "string",
+            "nullable": true
+          },
+          "internal_cc_price": {
+            "description": "Internal Canton-coin (CC) price in USD.\n\nThis is the price approved by the committee via voting and used internally for calculations, valuations, and settlement logic. Always present when set.",
+            "type": "string",
+            "nullable": true
+          },
+          "receivers": {
+            "description": "List of individual receiver breakdowns — who received what amount, after fees or net settlement.",
+            "items": {
+              "$ref": "#/definitions/Received"
+            },
+            "type": "array"
+          },
+          "sender_send": {
+            "description": "The gross amount of tokens debited from the sender’s balance (before fees; includes amounts sent to receivers + fees).",
+            "type": "string"
+          },
+          "total_change_fee": {
+            "description": "Fee associated with returning change to the sender (if UTXO or similar model is used).",
+            "format": "decimal",
+            "type": "string",
+            "example": "1.8"
+          },
+          "total_fee": {
+            "description": "The aggregate of all fees (`total_output_fee + total_change_fee + total_holder_fee`).",
+            "format": "decimal",
+            "type": "string",
+            "example": "1.97646"
+          },
+          "total_holder_fee": {
+            "description": "Fees paid to token holders or stakers (e.g., protocol-level holding or delegation fees).",
+            "format": "decimal",
+            "type": "string",
+            "example": "0.8"
+          },
+          "total_output_fee": {
+            "description": "Sum of fees paid for transferring tokens to receivers (e.g., routing or processing fees per output).",
+            "format": "decimal",
+            "type": "string",
+            "example": "0.6"
+          }
+        },
+        "required": [
+          "receivers",
+          "sender_send",
+          "total_change_fee",
+          "total_fee",
+          "total_holder_fee",
+          "total_output_fee"
+        ],
+        "type": "object"
+      },
+      "StatusEvent": {
+        "additionalProperties": false,
+        "properties": {
+          "connection": {
+            "$ref": "#/definitions/ConnectResult"
+          },
+          "network": {
+            "$ref": "#/definitions/ProviderNetwork"
+          },
+          "provider": {
+            "$ref": "#/definitions/Provider"
+          },
+          "session": {
+            "$ref": "#/definitions/Session"
+          }
+        },
+        "required": [
+          "connection",
+          "provider"
+        ],
+        "type": "object"
+      },
+      "TokenData": {
+        "additionalProperties": false,
+        "description": "Token balance data for a specific network.",
+        "properties": {
+          "balance": {
+            "type": "string"
+          },
+          "balanceBigInt": {
+            "type": "string"
+          },
+          "balanceUsd": {
+            "type": "string"
+          },
+          "decimals": {
+            "type": "number"
+          },
+          "id": {
+            "type": "string"
+          },
+          "imageSrc": {
+            "type": "string"
+          },
+          "name": {
+            "type": "string"
+          },
+          "network": {
+            "$ref": "#/definitions/CANTON_NETWORK_VARIANTS"
+          },
+          "price": {
+            "type": "string"
+          },
+          "symbol": {
+            "$ref": "#/definitions/CoinEnum"
+          }
+        },
+        "required": [
+          "id",
+          "symbol",
+          "balance",
+          "balanceBigInt",
+          "decimals",
+          "name",
+          "price",
+          "network",
+          "imageSrc"
+        ],
+        "type": "object"
+      },
+      "TokenTransferType": {
+        "default": "transfer",
+        "description": "Type of Token Transfer. One of: allocation, command, instuction, other.",
+        "enum": [
+          "allocation",
+          "command",
+          "instruction",
+          "transfer",
+          "merge_split"
+        ],
+        "type": "string",
+        "example": "allocation"
+      },
+      "TokenTransfersQuery": {
+        "description": "Query parameters accepted by the indexer for party token transfers.",
+        "not": {}
+      },
+      "TokenTransfersRequest": {
+        "additionalProperties": false,
+        "properties": {
+          "network": {
+            "$ref": "#/definitions/CANTON_NETWORK_VARIANTS"
+          }
+        },
+        "required": [
+          "network"
+        ],
+        "type": "object"
+      },
+      "TokenTransfersResponse": {
+        "anyOf": [
+          {
+            "$ref": "#/definitions/PagedByCombinedCursorResponseTokenTransferSummary"
+          },
+          {
+            "nullable": true
+          }
+        ],
+        "description": "Paged token transfer summaries or null if no data exists."
+      },
+      "TopologyTransactions": {
+        "description": "The topology transactions",
+        "type": "string"
+      },
+      "TransactionInstructionChoice": {
+        "enum": [
+          "Accept",
+          "Reject",
+          "Withdraw"
+        ],
+        "type": "string"
+      },
+      "TransferData": {
+        "additionalProperties": false,
+        "description": "Data Transfer Object representing a complete transfer request or record.\n\nContains sender, provider, recipients with outputs, fees, round context, and metadata. Used in transaction submission, auditing, or API responses.",
+        "properties": {
+          "holding_fee": {
+            "description": "The holding fee applied to the transfer, paid by the sender.\n\nExpressed in the base token (e.g., AMULET). This fee compensates the provider for temporary custody or processing.",
+            "format": "decimal",
+            "type": "string",
+            "example": 0.000123
+          },
+          "input_amount": {
+            "description": "The total input amount being transferred (before fees).\n\nMust match the sum of all output amounts and fees.",
+            "format": "decimal",
+            "type": "string",
+            "example": "100.0338"
+          },
+          "metadata": {
+            "additionalProperties": {
+              "type": "string"
+            },
+            "description": "Additional metadata associated with the transfer.\n\nKey-value tags for tracking, analytics, or compliance (e.g., \"source\", \"campaign\"). Not part of the cryptographic payload, but may be logged.",
+            "type": "object",
+            "example": {
+              "splice.lfdecentralizedtrust.org/burned": "0.8671428572",
+              "splice.lfdecentralizedtrust.org/sender": "v-7-user-3::122044310988c02106b5f0f37b76f997935db73dd2a49075067130c4d00fcc95a2c1",
+              "splice.lfdecentralizedtrust.org/tx-kind": "transfer"
+            }
+          },
+          "provider": {
+            "$ref": "#/definitions/PartyId",
+            "description": "The service provider facilitating the transfer (e.g., relayer, validator, DSO). May collect fees or enforce policies. This party is responsible for transaction inclusion.\n\n  Example: \"DSO::1220be58c29e65de40bf273be1dc2b266d43a9a002ea5b18955aeef7aac881bb471a\""
+          },
+          "receivers": {
+            "additionalProperties": {
+              "items": {
+                "$ref": "#/definitions/TransferOutput"
+              },
+              "type": "array"
+            },
+            "description": "Map of recipients to their list of transfer outputs.\n\nEach recipient (key) can receive multiple outputs (e.g., split payments, change). Used to support complex payout structures.",
+            "type": "object",
+            "example": {
+              "auth0_007c68658b8598cd2db9f3e70120::1220907f4c19293a3b5fb6ed3943938abe65647748090e34993387950631d0024444": [
+                {
+                  "amount": "1987.0388584460",
+                  "fee": "0.6000000000",
+                  "lock": null,
+                  "output_number": 0,
+                  "receiver_fee_ratio": "0"
+                }
+              ]
+            }
+          },
+          "round": {
+            "description": "The mining round in which this transfer is submitted or processed. Used for reward calculation, auditing, and economic modeling.",
+            "format": "int64",
+            "type": "number",
+            "example": 2
+          },
+          "sender": {
+            "$ref": "#/definitions/PartyId",
+            "description": "The party initiating the transfer. Must have sufficient balance and authorization to spend the input amount.\n\nExample: `dev_test_sender_email_com::122035334a67f4de9d2aecdd5b83485cbaee20682e3f0491bdf12b0a32d81cc93c90`"
+          },
+          "sender_change_amount": {
+            "description": "The unspent sender amount being transferred back.",
+            "format": "decimal",
+            "type": "string",
+            "example": 100
+          },
+          "sender_change_fee": {
+            "description": "The fee amount of creation change amulet.",
+            "format": "decimal",
+            "type": "string",
+            "example": 100
+          }
+        },
+        "required": [
+          "holding_fee",
+          "input_amount",
+          "metadata",
+          "provider",
+          "receivers",
+          "round",
+          "sender",
+          "sender_change_amount",
+          "sender_change_fee"
+        ],
+        "type": "object"
+      },
+      "TransferFromNodeRequest": {
+        "additionalProperties": false,
+        "description": "Request parameters for retrieving a single transfer by event ID.",
+        "properties": {
+          "network": {
+            "$ref": "#/definitions/CANTON_NETWORK_VARIANTS"
+          },
+          "transferId": {
+            "type": "number"
+          }
+        },
+        "required": [
+          "transferId",
+          "network"
+        ],
+        "type": "object"
+      },
+      "TransferFromNodeResponse": {
+        "anyOf": [
+          {
+            "$ref": "#/definitions/TransferResponseDTO"
+          },
+          {
+            "nullable": true
+          }
+        ],
+        "description": "Detailed transfer response or null if event is not found."
+      },
+      "TransferOutput": {
+        "additionalProperties": false,
+        "description": "Data Transfer Object representing a single output in a transfer transaction.\n\nThis includes the amount, fee distribution, and optional locking conditions.",
+        "properties": {
+          "amount": {
+            "description": "Total transfer amount sent to the receiver (excluding fees).\n\nExpressed in the base unit of the token (e.g., AMULET). This is the net amount the recipient receives after fees are deducted.",
+            "format": "decimal",
+            "type": "string",
+            "example": 50
+          },
+          "fee": {
+            "description": "The total fee amount deducted from the transfer.\n\nThis may include validators, DSO, or service provider fees. It is calculated based on the amount and applicable fee rules.",
+            "format": "decimal",
+            "type": "string",
+            "example": 0.5
+          },
+          "lock": {
+            "anyOf": [
+              {
+                "nullable": true
+              },
+              {
+                "$ref": "#/definitions/OutputTimeLock"
+              }
+            ],
+            "description": "Optional time lock that prevents the output from being spent before a certain time or block.\n\nIf present, the recipient cannot spend these funds until the lock conditions are met. Used for vesting, escrow, or delayed payouts."
+          },
+          "output_number": {
+            "description": "The index/number of the output in the transaction.\n\nIndicates the position of this output within the list of outputs. Used for referencing in scripts or off-ledger systems.",
+            "format": "int32",
+            "type": "number",
+            "example": 1
+          },
+          "receiver_fee_ratio": {
+            "description": "The fee ratio that the receiver agrees to pay, expressed as a decimal.\n\nFor example, `0.01` means the receiver pays 1% of the transfer as a fee. Used to incentivize on-chain activity or cover network costs.",
+            "format": "decimal",
+            "type": "string",
+            "example": 0.01
+          }
+        },
+        "required": [
+          "amount",
+          "fee",
+          "output_number",
+          "receiver_fee_ratio"
+        ],
+        "type": "object"
+      },
+      "TransferRequest": {
+        "additionalProperties": false,
+        "description": "Request parameters for retrieving a single transfer by event ID.",
+        "properties": {
+          "eventId": {
+            "type": "string"
+          },
+          "network": {
+            "$ref": "#/definitions/CANTON_NETWORK_VARIANTS"
+          }
+        },
+        "required": [
+          "eventId",
+          "network"
+        ],
+        "type": "object"
+      },
+      "TransferResponse": {
+        "anyOf": [
+          {
+            "description": "Failed to correctly infer type"
+          },
+          {
+            "nullable": true
+          }
+        ],
+        "description": "Detailed transfer response or null if event is not found."
+      },
+      "TransferResponseDTO": {
+        "additionalProperties": false,
+        "properties": {
+          "action": {
+            "enum": [
+              "create",
+              "resolve"
+            ],
+            "type": "string"
+          },
+          "amount": {
+            "type": "string"
+          },
+          "choice": {
+            "enum": [
+              "Accept",
+              "Reject",
+              "Withdraw",
+              null
+            ],
+            "type": "string",
+            "nullable": true
+          },
+          "coin": {
+            "enum": [
+              "CC",
+              "CBTC",
+              "USDCx"
+            ],
+            "type": "string"
+          },
+          "contractId": {
+            "type": "string",
+            "nullable": true
+          },
+          "createdAt": {
+            "format": "date-time",
+            "type": "string"
+          },
+          "holdingFee": {
+            "type": "string"
+          },
+          "id": {
+            "type": "number"
+          },
+          "offerCreatedAt": {
+            "format": "date-time",
+            "type": "string"
+          },
+          "outputFee": {
+            "type": "string"
+          },
+          "receiver": {
+            "type": "string"
+          },
+          "sender": {
+            "type": "string"
+          },
+          "senderFee": {
+            "type": "string"
+          },
+          "status": {
+            "enum": [
+              "Pending",
+              "SUCCESSFUL",
+              "FAILED",
+              "Accepted",
+              "Rejected"
+            ],
+            "type": "string"
+          },
+          "type": {
+            "enum": [
+              "Instruction",
+              "Transfer",
+              "BATCH_TRANSFER",
+              "BATCH_MARKERS",
+              "MERGE_UTXOS"
+            ],
+            "type": "string"
+          }
+        },
+        "required": [
+          "action",
+          "amount",
+          "choice",
+          "coin",
+          "createdAt",
+          "holdingFee",
+          "id",
+          "offerCreatedAt",
+          "outputFee",
+          "receiver",
+          "sender",
+          "senderFee",
+          "status",
+          "type"
+        ],
+        "type": "object"
+      },
+      "TxChangedEvent": {
+        "anyOf": [
+          {
+            "$ref": "#/definitions/TxChangedPendingEvent"
+          },
+          {
+            "$ref": "#/definitions/TxChangedSignedEvent"
+          },
+          {
+            "$ref": "#/definitions/TxChangedExecutedEvent"
+          },
+          {
+            "$ref": "#/definitions/TxChangedFailedEvent"
+          }
+        ],
+        "description": "Union of all transaction status change events."
+      },
+      "TxChangedExecutedEvent": {
+        "additionalProperties": false,
+        "description": "Trigger event emitted when a transaction is executed.",
+        "properties": {
+          "commandId": {
+            "type": "string"
+          },
+          "payload": {
+            "$ref": "#/definitions/TxChangedExecutedPayload"
+          },
+          "status": {
+            "type": "string",
+            "enum": [
+              "executed"
+            ]
+          }
+        },
+        "required": [
+          "status",
+          "commandId",
+          "payload"
+        ],
+        "type": "object"
+      },
+      "TxChangedExecutedPayload": {
+        "additionalProperties": false,
+        "description": "Payload included when a transaction reaches execution/finalization.",
+        "properties": {
+          "completionOffset": {
+            "type": "number"
+          },
+          "updateId": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "updateId",
+          "completionOffset"
+        ],
+        "type": "object"
+      },
+      "TxChangedFailedEvent": {
+        "additionalProperties": false,
+        "description": "Trigger event emitted when a transaction fails.",
+        "properties": {
+          "commandId": {
+            "type": "string"
+          },
+          "status": {
+            "type": "string",
+            "enum": [
+              "failed"
+            ]
+          }
+        },
+        "required": [
+          "status",
+          "commandId"
+        ],
+        "type": "object"
+      },
+      "TxChangedPendingEvent": {
+        "additionalProperties": false,
+        "description": "Trigger event emitted when a transaction is queued/pending.",
+        "properties": {
+          "commandId": {
+            "type": "string"
+          },
+          "status": {
+            "type": "string",
+            "enum": [
+              "pending"
+            ]
+          }
+        },
+        "required": [
+          "status",
+          "commandId"
+        ],
+        "type": "object"
+      },
+      "TxChangedSignedEvent": {
+        "additionalProperties": false,
+        "description": "Trigger event emitted when the wallet signs a transaction.",
+        "properties": {
+          "commandId": {
+            "type": "string"
+          },
+          "payload": {
+            "$ref": "#/definitions/TxChangedSignedPayload"
+          },
+          "status": {
+            "type": "string",
+            "enum": [
+              "signed"
+            ]
+          }
+        },
+        "required": [
+          "status",
+          "commandId",
+          "payload"
+        ],
+        "type": "object"
+      },
+      "TxChangedSignedPayload": {
+        "additionalProperties": false,
+        "description": "Payload included when a transaction is signed.",
+        "properties": {
+          "party": {
+            "type": "string"
+          },
+          "signature": {
+            "type": "string"
+          },
+          "signedBy": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "signature",
+          "signedBy",
+          "party"
+        ],
+        "type": "object"
+      },
+      "TxEventStatus": {
+        "description": "Transaction lifecycle status values used in wallet trigger events.",
+        "enum": [
+          "pending",
+          "signed",
+          "executed",
+          "failed"
+        ],
+        "type": "string"
+      },
+      "Wallet": {
+        "additionalProperties": false,
+        "description": "Structure representing a wallet",
+        "properties": {
+          "externalTxId": {
+            "$ref": "#/definitions/ExternalTxId"
+          },
+          "hint": {
+            "$ref": "#/definitions/Hint"
+          },
+          "namespace": {
+            "$ref": "#/definitions/Namespace"
+          },
+          "networkId": {
+            "$ref": "#/definitions/CANTON_NETWORK_VARIANTS"
+          },
+          "partyId": {
+            "$ref": "#/definitions/PartyId"
+          },
+          "primary": {
+            "$ref": "#/definitions/Primary"
+          },
+          "publicKey": {
+            "$ref": "#/definitions/PublicKey"
+          },
+          "signingProviderId": {
+            "$ref": "#/definitions/SigningProviderId"
+          },
+          "status": {
+            "$ref": "#/definitions/WalletStatus"
+          },
+          "topologyTransactions": {
+            "$ref": "#/definitions/TopologyTransactions"
+          }
+        },
+        "required": [
+          "primary",
+          "status",
+          "partyId",
+          "hint",
+          "publicKey",
+          "namespace",
+          "networkId",
+          "signingProviderId"
+        ],
+        "type": "object"
+      },
+      "WalletStatus": {
+        "description": "The status of the wallet.",
+        "enum": [
+          "initialized",
+          "allocated"
+        ],
+        "type": "string"
+      },
+      "WalletVersion": {
+        "description": "Wallet version",
+        "type": "string"
+      }
+    }
+  }
+}