@1claw/openapi-spec 0.36.0 → 0.37.0

package/README.md

@@ -43,7 +43,8 @@ import spec from "@1claw/openapi-spec/openapi.json";
 ## What's in the spec (v0.36.0 — API `info.version` 2.23.0)
 
 ### Non-EVM transaction signing (2.23)
-- **Intents API** — `SubmitTransactionRequest` / `SignTransactionRequest` extended with non-EVM fields: `destination_tag` (XRP), `memo`, `fee_rate_sat_per_vbyte` (Bitcoin), `fee_limit_sun` (Tron), `token_mint` / `token_decimals` (Solana SPL + Tron TRC-20), `ttl` (Cardano). Native sign + broadcast for Bitcoin, Solana, XRP, Cardano, Tron.
+- **Intents API** — `SubmitTransactionRequest` / `SignTransactionRequest` / `SignIntentRequest` extended with non-EVM fields: `destination_tag` (XRP), `memo`, `fee_rate_sat_per_vbyte` (Bitcoin), `fee_limit_sun` (Tron), `token_mint` / `token_decimals` (Solana SPL + Tron TRC-20), `ttl` (Cardano). Native sign + broadcast for Bitcoin, Solana, XRP, Cardano, Tron.
+- **`xrpl_tx_json`** — Optional raw XRPL transaction JSON for 30+ transaction types beyond simple Payment. Supported types include TrustSet, OfferCreate, OfferCancel, AccountSet, AccountDelete, EscrowCreate/Finish/Cancel, PaymentChannelCreate/Fund/Claim, NFTokenMint/Burn/CreateOffer/AcceptOffer/CancelOffer, AMMCreate/Deposit/Withdraw/Bid/Delete/Vote, SetRegularKey, SignerListSet, DepositPreauth, CheckCreate/Cash/Cancel, TicketCreate, Clawback. Server auto-fills `Account`, `Sequence`, `Fee`, `Flags`, `LastLedgerSequence`, `SigningPubKey`. Legacy `to`/`value`/`destination_tag` Payment path preserved for backward compatibility.
 
 ### Risk Engine & DPoP (2.19)
 - **Risk events** — `GET /v1/risk/events` (list, filterable by severity/principal_type)

package/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.1.0",
   "info": {
     "title": "1Claw API",
-    "version": "2.23.0",
+    "version": "2.24.0",
     "description": "Secure secret management for AI agents. Provides vaults, secrets,\npolicy-based access control, agent identity, Intents API,\nsharing, billing, and audit logging.\n\nAll endpoints require JWT Bearer authentication unless marked with\n`security: []`.\n",
     "contact": {
       "email": "ops@1claw.xyz"
@@ -11841,6 +11841,11 @@
           "ttl": {
             "type": "integer",
             "description": "Non-EVM (Cardano): transaction time-to-live (absolute slot)"
+          },
+          "xrpl_tx_json": {
+            "type": "object",
+            "additionalProperties": true,
+            "description": "Raw XRPL transaction JSON for full transaction type coverage. When present (and chain is XRP), the handler uses the xrpl-rust binary codec to encode and sign the transaction as-is. Supports all XRPL transaction types: Payment, TrustSet, OfferCreate, OfferCancel, AccountSet, EscrowCreate, NFTokenMint, AMMCreate, and 20+ more. Account, Sequence, Fee, LastLedgerSequence, and SigningPubKey are auto-filled when absent.\n"
           }
         }
       },
@@ -11918,6 +11923,11 @@
           "ttl": {
             "type": "integer",
             "description": "Non-EVM (Cardano): transaction time-to-live (absolute slot)"
+          },
+          "xrpl_tx_json": {
+            "type": "object",
+            "additionalProperties": true,
+            "description": "Raw XRPL transaction JSON for full transaction type coverage. When present (and chain is XRP), the handler uses the xrpl-rust binary codec to encode and sign the transaction as-is. Supports all XRPL transaction types: Payment, TrustSet, OfferCreate, OfferCancel, AccountSet, EscrowCreate, NFTokenMint, AMMCreate, and 20+ more. Account, Sequence, Fee, LastLedgerSequence, and SigningPubKey are auto-filled when absent.\n"
           }
         }
       },
@@ -12259,6 +12269,43 @@
             "items": {
               "type": "object"
             }
+          },
+          "sign_only": {
+            "type": "boolean",
+            "description": "When true, sign only (do not broadcast). Non-EVM transaction intents only."
+          },
+          "destination_tag": {
+            "type": "integer",
+            "description": "Non-EVM (XRP): destination tag for exchange deposits"
+          },
+          "memo": {
+            "type": "string",
+            "description": "Non-EVM (XRP, Solana): optional memo"
+          },
+          "fee_rate_sat_per_vbyte": {
+            "type": "integer",
+            "description": "Non-EVM (Bitcoin): override the fetched fee rate (sat/vByte)"
+          },
+          "fee_limit_sun": {
+            "type": "integer",
+            "description": "Non-EVM (Tron): TRC-20 energy fee limit in sun"
+          },
+          "token_mint": {
+            "type": "string",
+            "description": "Non-EVM (Solana SPL / Tron TRC-20): token mint or contract address; omit for native transfer"
+          },
+          "token_decimals": {
+            "type": "integer",
+            "description": "Non-EVM (Solana, Tron): token decimals (default 6)"
+          },
+          "ttl": {
+            "type": "integer",
+            "description": "Non-EVM (Cardano): transaction time-to-live (absolute slot)"
+          },
+          "xrpl_tx_json": {
+            "type": "object",
+            "additionalProperties": true,
+            "description": "Raw XRPL transaction JSON for full transaction type coverage. When present (and chain is XRP), the handler uses the xrpl-rust binary codec to encode and sign the transaction as-is. Supports all XRPL transaction types: Payment, TrustSet, OfferCreate, OfferCancel, AccountSet, EscrowCreate, NFTokenMint, AMMCreate, and 20+ more. Account, Sequence, Fee, LastLedgerSequence, and SigningPubKey are auto-filled when absent.\n"
           }
         }
       },

package/openapi.yaml

@@ -2,7 +2,7 @@ openapi: 3.1.0
 
 info:
     title: 1Claw API
-    version: 2.23.0
+    version: 2.24.0
     description: |
         Secure secret management for AI agents. Provides vaults, secrets,
         policy-based access control, agent identity, Intents API,
@@ -7722,6 +7722,17 @@ components:
                 ttl:
                     type: integer
                     description: "Non-EVM (Cardano): transaction time-to-live (absolute slot)"
+                xrpl_tx_json:
+                    type: object
+                    additionalProperties: true
+                    description: >
+                        Raw XRPL transaction JSON for full transaction type coverage.
+                        When present (and chain is XRP), the handler uses the xrpl-rust
+                        binary codec to encode and sign the transaction as-is. Supports
+                        all XRPL transaction types: Payment, TrustSet, OfferCreate,
+                        OfferCancel, AccountSet, EscrowCreate, NFTokenMint, AMMCreate,
+                        and 20+ more. Account, Sequence, Fee, LastLedgerSequence, and
+                        SigningPubKey are auto-filled when absent.
 
         SignTransactionRequest:
             type: object
@@ -7776,6 +7787,17 @@ components:
                 ttl:
                     type: integer
                     description: "Non-EVM (Cardano): transaction time-to-live (absolute slot)"
+                xrpl_tx_json:
+                    type: object
+                    additionalProperties: true
+                    description: >
+                        Raw XRPL transaction JSON for full transaction type coverage.
+                        When present (and chain is XRP), the handler uses the xrpl-rust
+                        binary codec to encode and sign the transaction as-is. Supports
+                        all XRPL transaction types: Payment, TrustSet, OfferCreate,
+                        OfferCancel, AccountSet, EscrowCreate, NFTokenMint, AMMCreate,
+                        and 20+ more. Account, Sequence, Fee, LastLedgerSequence, and
+                        SigningPubKey are auto-filled when absent.
 
         SignTransactionResponse:
             type: object
@@ -8013,6 +8035,41 @@ components:
                     type: array
                     items:
                         type: object
+                sign_only:
+                    type: boolean
+                    description: "When true, sign only (do not broadcast). Non-EVM transaction intents only."
+                destination_tag:
+                    type: integer
+                    description: "Non-EVM (XRP): destination tag for exchange deposits"
+                memo:
+                    type: string
+                    description: "Non-EVM (XRP, Solana): optional memo"
+                fee_rate_sat_per_vbyte:
+                    type: integer
+                    description: "Non-EVM (Bitcoin): override the fetched fee rate (sat/vByte)"
+                fee_limit_sun:
+                    type: integer
+                    description: "Non-EVM (Tron): TRC-20 energy fee limit in sun"
+                token_mint:
+                    type: string
+                    description: "Non-EVM (Solana SPL / Tron TRC-20): token mint or contract address; omit for native transfer"
+                token_decimals:
+                    type: integer
+                    description: "Non-EVM (Solana, Tron): token decimals (default 6)"
+                ttl:
+                    type: integer
+                    description: "Non-EVM (Cardano): transaction time-to-live (absolute slot)"
+                xrpl_tx_json:
+                    type: object
+                    additionalProperties: true
+                    description: >
+                        Raw XRPL transaction JSON for full transaction type coverage.
+                        When present (and chain is XRP), the handler uses the xrpl-rust
+                        binary codec to encode and sign the transaction as-is. Supports
+                        all XRPL transaction types: Payment, TrustSet, OfferCreate,
+                        OfferCancel, AccountSet, EscrowCreate, NFTokenMint, AMMCreate,
+                        and 20+ more. Account, Sequence, Fee, LastLedgerSequence, and
+                        SigningPubKey are auto-filled when absent.
 
         SignIntentResponse:
             type: object

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@1claw/openapi-spec",
-  "version": "0.36.0",
+  "version": "0.37.0",
   "description": "OpenAPI 3.1.0 specification for the 1Claw Vault API — generate clients in any language",
   "license": "MIT",
   "repository": {