@1claw/openapi-spec 0.35.0 → 0.37.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/README.md +6 -2
  2. package/openapi.json +104 -1
  3. package/openapi.yaml +100 -1
  4. package/package.json +1 -1
package/README.md CHANGED
@@ -40,13 +40,17 @@ openapi-generator generate \
40
40
  import spec from "@1claw/openapi-spec/openapi.json";
41
41
  ```
42
42
 
43
- ## What's in the spec (v0.34.1 — API `info.version` 2.19.0)
43
+ ## What's in the spec (v0.36.0 — API `info.version` 2.23.0)
44
+
45
+ ### Non-EVM transaction signing (2.23)
46
+ - **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.
47
+ - **`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.
44
48
 
45
49
  ### Risk Engine & DPoP (2.19)
46
50
  - **Risk events** — `GET /v1/risk/events` (list, filterable by severity/principal_type)
47
51
  - **Risk verdicts** — `GET /v1/risk/verdicts` (active verdicts), `GET /v1/risk/verdicts/{type}/{id}` (single principal verdict)
48
52
  - **Honeytokens** — `GET/POST/DELETE /v1/risk/honeytokens` (canary secret CRUD with trigger counts)
49
- - **DPoP** — RFC 9449 Demonstration of Proof-of-Possession token binding (planned spec addition)
53
+ - **DPoP** — RFC 9449 Demonstration of Proof-of-Possession token binding (shipped)
50
54
 
51
55
  ### Webhooks (2.19)
52
56
  - **Webhook CRUD** — `POST/GET /v1/webhooks`, `GET/PATCH/DELETE /v1/webhooks/{id}`. Events: `wallet.transfer.*`, `proposal.*`, `agent.transaction.*`, `signing_key.rotated`, `policy.*`
package/openapi.json CHANGED
@@ -2,7 +2,7 @@
2
2
  "openapi": "3.1.0",
3
3
  "info": {
4
4
  "title": "1Claw API",
5
- "version": "2.22.0",
5
+ "version": "2.24.0",
6
6
  "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",
7
7
  "contact": {
8
8
  "email": "ops@1claw.xyz"
@@ -11813,6 +11813,39 @@
11813
11813
  "type": "boolean",
11814
11814
  "description": "Whether to submit as a gasless (sponsored) transaction",
11815
11815
  "default": false
11816
+ },
11817
+ "destination_tag": {
11818
+ "type": "integer",
11819
+ "description": "Non-EVM (XRP): destination tag for exchange deposits"
11820
+ },
11821
+ "memo": {
11822
+ "type": "string",
11823
+ "description": "Non-EVM (XRP, Solana): optional memo"
11824
+ },
11825
+ "fee_rate_sat_per_vbyte": {
11826
+ "type": "integer",
11827
+ "description": "Non-EVM (Bitcoin): override the fetched fee rate (sat/vByte)"
11828
+ },
11829
+ "fee_limit_sun": {
11830
+ "type": "integer",
11831
+ "description": "Non-EVM (Tron): TRC-20 energy fee limit in sun"
11832
+ },
11833
+ "token_mint": {
11834
+ "type": "string",
11835
+ "description": "Non-EVM (Solana SPL / Tron TRC-20): token mint or contract address; omit for native transfer"
11836
+ },
11837
+ "token_decimals": {
11838
+ "type": "integer",
11839
+ "description": "Non-EVM (Solana, Tron): token decimals (default 6)"
11840
+ },
11841
+ "ttl": {
11842
+ "type": "integer",
11843
+ "description": "Non-EVM (Cardano): transaction time-to-live (absolute slot)"
11844
+ },
11845
+ "xrpl_tx_json": {
11846
+ "type": "object",
11847
+ "additionalProperties": true,
11848
+ "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"
11816
11849
  }
11817
11850
  }
11818
11851
  },
@@ -11862,6 +11895,39 @@
11862
11895
  "simulate_first": {
11863
11896
  "type": "boolean",
11864
11897
  "default": false
11898
+ },
11899
+ "destination_tag": {
11900
+ "type": "integer",
11901
+ "description": "Non-EVM (XRP): destination tag for exchange deposits"
11902
+ },
11903
+ "memo": {
11904
+ "type": "string",
11905
+ "description": "Non-EVM (XRP, Solana): optional memo"
11906
+ },
11907
+ "fee_rate_sat_per_vbyte": {
11908
+ "type": "integer",
11909
+ "description": "Non-EVM (Bitcoin): override the fetched fee rate (sat/vByte)"
11910
+ },
11911
+ "fee_limit_sun": {
11912
+ "type": "integer",
11913
+ "description": "Non-EVM (Tron): TRC-20 energy fee limit in sun"
11914
+ },
11915
+ "token_mint": {
11916
+ "type": "string",
11917
+ "description": "Non-EVM (Solana SPL / Tron TRC-20): token mint or contract address; omit for native transfer"
11918
+ },
11919
+ "token_decimals": {
11920
+ "type": "integer",
11921
+ "description": "Non-EVM (Solana, Tron): token decimals (default 6)"
11922
+ },
11923
+ "ttl": {
11924
+ "type": "integer",
11925
+ "description": "Non-EVM (Cardano): transaction time-to-live (absolute slot)"
11926
+ },
11927
+ "xrpl_tx_json": {
11928
+ "type": "object",
11929
+ "additionalProperties": true,
11930
+ "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"
11865
11931
  }
11866
11932
  }
11867
11933
  },
@@ -12203,6 +12269,43 @@
12203
12269
  "items": {
12204
12270
  "type": "object"
12205
12271
  }
12272
+ },
12273
+ "sign_only": {
12274
+ "type": "boolean",
12275
+ "description": "When true, sign only (do not broadcast). Non-EVM transaction intents only."
12276
+ },
12277
+ "destination_tag": {
12278
+ "type": "integer",
12279
+ "description": "Non-EVM (XRP): destination tag for exchange deposits"
12280
+ },
12281
+ "memo": {
12282
+ "type": "string",
12283
+ "description": "Non-EVM (XRP, Solana): optional memo"
12284
+ },
12285
+ "fee_rate_sat_per_vbyte": {
12286
+ "type": "integer",
12287
+ "description": "Non-EVM (Bitcoin): override the fetched fee rate (sat/vByte)"
12288
+ },
12289
+ "fee_limit_sun": {
12290
+ "type": "integer",
12291
+ "description": "Non-EVM (Tron): TRC-20 energy fee limit in sun"
12292
+ },
12293
+ "token_mint": {
12294
+ "type": "string",
12295
+ "description": "Non-EVM (Solana SPL / Tron TRC-20): token mint or contract address; omit for native transfer"
12296
+ },
12297
+ "token_decimals": {
12298
+ "type": "integer",
12299
+ "description": "Non-EVM (Solana, Tron): token decimals (default 6)"
12300
+ },
12301
+ "ttl": {
12302
+ "type": "integer",
12303
+ "description": "Non-EVM (Cardano): transaction time-to-live (absolute slot)"
12304
+ },
12305
+ "xrpl_tx_json": {
12306
+ "type": "object",
12307
+ "additionalProperties": true,
12308
+ "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"
12206
12309
  }
12207
12310
  }
12208
12311
  },
package/openapi.yaml CHANGED
@@ -2,7 +2,7 @@ openapi: 3.1.0
2
2
 
3
3
  info:
4
4
  title: 1Claw API
5
- version: 2.22.0
5
+ version: 2.24.0
6
6
  description: |
7
7
  Secure secret management for AI agents. Provides vaults, secrets,
8
8
  policy-based access control, agent identity, Intents API,
@@ -7701,6 +7701,38 @@ components:
7701
7701
  type: boolean
7702
7702
  description: Whether to submit as a gasless (sponsored) transaction
7703
7703
  default: false
7704
+ destination_tag:
7705
+ type: integer
7706
+ description: "Non-EVM (XRP): destination tag for exchange deposits"
7707
+ memo:
7708
+ type: string
7709
+ description: "Non-EVM (XRP, Solana): optional memo"
7710
+ fee_rate_sat_per_vbyte:
7711
+ type: integer
7712
+ description: "Non-EVM (Bitcoin): override the fetched fee rate (sat/vByte)"
7713
+ fee_limit_sun:
7714
+ type: integer
7715
+ description: "Non-EVM (Tron): TRC-20 energy fee limit in sun"
7716
+ token_mint:
7717
+ type: string
7718
+ description: "Non-EVM (Solana SPL / Tron TRC-20): token mint or contract address; omit for native transfer"
7719
+ token_decimals:
7720
+ type: integer
7721
+ description: "Non-EVM (Solana, Tron): token decimals (default 6)"
7722
+ ttl:
7723
+ type: integer
7724
+ description: "Non-EVM (Cardano): transaction time-to-live (absolute slot)"
7725
+ xrpl_tx_json:
7726
+ type: object
7727
+ additionalProperties: true
7728
+ description: >
7729
+ Raw XRPL transaction JSON for full transaction type coverage.
7730
+ When present (and chain is XRP), the handler uses the xrpl-rust
7731
+ binary codec to encode and sign the transaction as-is. Supports
7732
+ all XRPL transaction types: Payment, TrustSet, OfferCreate,
7733
+ OfferCancel, AccountSet, EscrowCreate, NFTokenMint, AMMCreate,
7734
+ and 20+ more. Account, Sequence, Fee, LastLedgerSequence, and
7735
+ SigningPubKey are auto-filled when absent.
7704
7736
 
7705
7737
  SignTransactionRequest:
7706
7738
  type: object
@@ -7734,6 +7766,38 @@ components:
7734
7766
  simulate_first:
7735
7767
  type: boolean
7736
7768
  default: false
7769
+ destination_tag:
7770
+ type: integer
7771
+ description: "Non-EVM (XRP): destination tag for exchange deposits"
7772
+ memo:
7773
+ type: string
7774
+ description: "Non-EVM (XRP, Solana): optional memo"
7775
+ fee_rate_sat_per_vbyte:
7776
+ type: integer
7777
+ description: "Non-EVM (Bitcoin): override the fetched fee rate (sat/vByte)"
7778
+ fee_limit_sun:
7779
+ type: integer
7780
+ description: "Non-EVM (Tron): TRC-20 energy fee limit in sun"
7781
+ token_mint:
7782
+ type: string
7783
+ description: "Non-EVM (Solana SPL / Tron TRC-20): token mint or contract address; omit for native transfer"
7784
+ token_decimals:
7785
+ type: integer
7786
+ description: "Non-EVM (Solana, Tron): token decimals (default 6)"
7787
+ ttl:
7788
+ type: integer
7789
+ description: "Non-EVM (Cardano): transaction time-to-live (absolute slot)"
7790
+ xrpl_tx_json:
7791
+ type: object
7792
+ additionalProperties: true
7793
+ description: >
7794
+ Raw XRPL transaction JSON for full transaction type coverage.
7795
+ When present (and chain is XRP), the handler uses the xrpl-rust
7796
+ binary codec to encode and sign the transaction as-is. Supports
7797
+ all XRPL transaction types: Payment, TrustSet, OfferCreate,
7798
+ OfferCancel, AccountSet, EscrowCreate, NFTokenMint, AMMCreate,
7799
+ and 20+ more. Account, Sequence, Fee, LastLedgerSequence, and
7800
+ SigningPubKey are auto-filled when absent.
7737
7801
 
7738
7802
  SignTransactionResponse:
7739
7803
  type: object
@@ -7971,6 +8035,41 @@ components:
7971
8035
  type: array
7972
8036
  items:
7973
8037
  type: object
8038
+ sign_only:
8039
+ type: boolean
8040
+ description: "When true, sign only (do not broadcast). Non-EVM transaction intents only."
8041
+ destination_tag:
8042
+ type: integer
8043
+ description: "Non-EVM (XRP): destination tag for exchange deposits"
8044
+ memo:
8045
+ type: string
8046
+ description: "Non-EVM (XRP, Solana): optional memo"
8047
+ fee_rate_sat_per_vbyte:
8048
+ type: integer
8049
+ description: "Non-EVM (Bitcoin): override the fetched fee rate (sat/vByte)"
8050
+ fee_limit_sun:
8051
+ type: integer
8052
+ description: "Non-EVM (Tron): TRC-20 energy fee limit in sun"
8053
+ token_mint:
8054
+ type: string
8055
+ description: "Non-EVM (Solana SPL / Tron TRC-20): token mint or contract address; omit for native transfer"
8056
+ token_decimals:
8057
+ type: integer
8058
+ description: "Non-EVM (Solana, Tron): token decimals (default 6)"
8059
+ ttl:
8060
+ type: integer
8061
+ description: "Non-EVM (Cardano): transaction time-to-live (absolute slot)"
8062
+ xrpl_tx_json:
8063
+ type: object
8064
+ additionalProperties: true
8065
+ description: >
8066
+ Raw XRPL transaction JSON for full transaction type coverage.
8067
+ When present (and chain is XRP), the handler uses the xrpl-rust
8068
+ binary codec to encode and sign the transaction as-is. Supports
8069
+ all XRPL transaction types: Payment, TrustSet, OfferCreate,
8070
+ OfferCancel, AccountSet, EscrowCreate, NFTokenMint, AMMCreate,
8071
+ and 20+ more. Account, Sequence, Fee, LastLedgerSequence, and
8072
+ SigningPubKey are auto-filled when absent.
7974
8073
 
7975
8074
  SignIntentResponse:
7976
8075
  type: object
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@1claw/openapi-spec",
3
- "version": "0.35.0",
3
+ "version": "0.37.0",
4
4
  "description": "OpenAPI 3.1.0 specification for the 1Claw Vault API — generate clients in any language",
5
5
  "license": "MIT",
6
6
  "repository": {