@cancore/contracts 0.2.0-rc.10 → 0.2.0-rc.13

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.
package/dist/index.js CHANGED
@@ -18,10 +18,11 @@ var DEPLOYMENTS = {
18
18
  { network: "robinhood_testnet", chainId: 46630, htlc: "0x5eBf3faAf3a86c37dDf6a46075b8366Ed4D8021A", htlcBlock: 96742769, multiBalanceChecker: "0x9548fd6fA8A3869b215E9D86F6a2628Bf2BEFB74" }
19
19
  ],
20
20
  devnet: [
21
- { network: "sepolia", chainId: 11155111, htlc: "0xc74469B26206A7b3Aee2781EC21F9F47a1552DD6", htlcBlock: 10469876 },
22
- { network: "bnb_testnet", chainId: 97, htlc: "0xC649d578FD0122E2Ce3Bcf6b89E3ef2564d1a30D", htlcBlock: 96439032 },
23
- { network: "arbitrum_sepolia", chainId: 421614, htlc: "0xE23A046Df3542C4C548162adab4397956b136031", htlcBlock: 251260393 },
24
- { network: "robinhood_testnet", chainId: 46630, htlc: "0x58D154441Fd7efEd22E49Eda369909DdbE54cC0a", htlcBlock: 96651438, multiBalanceChecker: "0x1b2A32A976F904a1fca87D427239635Ccd97FaFb" }
21
+ // Routers: evm-contracts deployments/router/dev/*.json (#120, CAN-2327), verified on chain 2026-10-14.
22
+ { network: "sepolia", chainId: 11155111, htlc: "0xc74469B26206A7b3Aee2781EC21F9F47a1552DD6", htlcBlock: 10469876, router: "0xfd227a0de77807206f4eEF9eE6eDd5795a45EF95", routerBlock: 11913649 },
23
+ { network: "bnb_testnet", chainId: 97, htlc: "0xC649d578FD0122E2Ce3Bcf6b89E3ef2564d1a30D", htlcBlock: 96439032, router: "0x57A8ad8392C5fF21aF52Fc3Cf246C1a464aCc6B1", routerBlock: 136752813 },
24
+ { network: "arbitrum_sepolia", chainId: 421614, htlc: "0xE23A046Df3542C4C548162adab4397956b136031", htlcBlock: 251260393, router: "0x7e27831316F7Ee8E44B96056F4354A6D1a22953a", routerBlock: 319105856 },
25
+ { network: "robinhood_testnet", chainId: 46630, htlc: "0x58D154441Fd7efEd22E49Eda369909DdbE54cC0a", htlcBlock: 96651438, multiBalanceChecker: "0x1b2A32A976F904a1fca87D427239635Ccd97FaFb", router: "0xF833A980ae858fe3cD14a79a9f610525AbB95BF9", routerBlock: 135089078 }
25
26
  ]
26
27
  };
27
28
  var PERMIT2_ADDRESS = "0x000000000022D473030F116dDEE9F6B43aC78BA3";
@@ -711,7 +712,9 @@ var FILLER_UPGRADE_REFUSALS = {
711
712
  var FILLER_GATEWAYS = {
712
713
  mainnet: { gateway: null, ticketSigners: [] },
713
714
  testnet: { gateway: null, ticketSigners: [] },
714
- devnet: { gateway: null, ticketSigners: [] }
715
+ // The ticket signer every dev router registers (evm-contracts deployments/router/dev/*.input.json, CAN-2331).
716
+ // The gateway key is published with the gateway release.
717
+ devnet: { gateway: null, ticketSigners: ["0x9a3fc3f44cddbdfb036a8c8a528a903d0c835c1c"] }
715
718
  };
716
719
 
717
720
  // src/protocol/messages.ts
@@ -747,7 +750,11 @@ var ERROR_CODES = [
747
750
  "NOT_ELIGIBLE",
748
751
  "RATE_LIMITED",
749
752
  "INTERNAL",
750
- "ATTESTATIONS_NOT_READY"
753
+ "ATTESTATIONS_NOT_READY",
754
+ "CANTON_NOT_READY",
755
+ "CANTON_REFUSED",
756
+ "CANTON_UNAVAILABLE",
757
+ "OPERATION_EXPIRED"
751
758
  ];
752
759
  var ERROR_HTTP_STATUS = {
753
760
  BAD_REQUEST: 400,
@@ -764,7 +771,11 @@ var ERROR_HTTP_STATUS = {
764
771
  NOT_ELIGIBLE: 403,
765
772
  RATE_LIMITED: 429,
766
773
  INTERNAL: 500,
767
- ATTESTATIONS_NOT_READY: 404
774
+ ATTESTATIONS_NOT_READY: 404,
775
+ CANTON_NOT_READY: 409,
776
+ CANTON_REFUSED: 422,
777
+ CANTON_UNAVAILABLE: 503,
778
+ OPERATION_EXPIRED: 410
768
779
  };
769
780
  var TICKET_REFUSED_REASONS = [
770
781
  "REPAY_TO_INVALID",
@@ -785,6 +796,10 @@ var QUOTE_FINAL_STATUSES = [...QUOTE_ACK_STATUSES, "REPLACED", "BAD_SIG", "OUTLI
785
796
  var PENALTY_STEPS = ["L1", "L2", "L3", "L4"];
786
797
  var DRAW_CLOSED_BY = ["OFFER_TIMEOUT", "OFFER_DECLINE", "TICKET_DECLINE", "TICKET_EXPIRED", "FILLED"];
787
798
  var TICKET_LIST_STATUSES = ["OFFERED", "ISSUED"];
799
+ var CANTON_OPS = ["party.allocate", "registry.accept", "delivery.fill", "intent.settle", "holdings.transfer"];
800
+ var CANTON_TRANSFER_OUTCOMES = ["COMPLETED", "PENDING"];
801
+ var CANTON_LEG_KINDS = ["transaction", "topology"];
802
+ var CANTON_REGISTRY_STATES = ["NONE", "PROPOSED", "ACTIVE", "REMOVED"];
788
803
 
789
804
  // spec/protocol/asyncapi.json
790
805
  var asyncapi_default = {
@@ -921,6 +936,18 @@ var asyncapi_default = {
921
936
  },
922
937
  "settle.attestations": {
923
938
  $ref: "#/components/messages/settle.attestations"
939
+ },
940
+ "canton.prepare": {
941
+ $ref: "#/components/messages/canton.prepare"
942
+ },
943
+ "canton.prepared": {
944
+ $ref: "#/components/messages/canton.prepared"
945
+ },
946
+ "canton.submit": {
947
+ $ref: "#/components/messages/canton.submit"
948
+ },
949
+ "canton.submitted": {
950
+ $ref: "#/components/messages/canton.submitted"
924
951
  }
925
952
  }
926
953
  }
@@ -1189,6 +1216,50 @@ var asyncapi_default = {
1189
1216
  $ref: "#/channels/filler/messages/settle.attestations"
1190
1217
  }
1191
1218
  ]
1219
+ },
1220
+ receiveCantonPrepare: {
1221
+ action: "receive",
1222
+ channel: {
1223
+ $ref: "#/channels/filler"
1224
+ },
1225
+ messages: [
1226
+ {
1227
+ $ref: "#/channels/filler/messages/canton.prepare"
1228
+ }
1229
+ ]
1230
+ },
1231
+ sendCantonPrepared: {
1232
+ action: "send",
1233
+ channel: {
1234
+ $ref: "#/channels/filler"
1235
+ },
1236
+ messages: [
1237
+ {
1238
+ $ref: "#/channels/filler/messages/canton.prepared"
1239
+ }
1240
+ ]
1241
+ },
1242
+ receiveCantonSubmit: {
1243
+ action: "receive",
1244
+ channel: {
1245
+ $ref: "#/channels/filler"
1246
+ },
1247
+ messages: [
1248
+ {
1249
+ $ref: "#/channels/filler/messages/canton.submit"
1250
+ }
1251
+ ]
1252
+ },
1253
+ sendCantonSubmitted: {
1254
+ action: "send",
1255
+ channel: {
1256
+ $ref: "#/channels/filler"
1257
+ },
1258
+ messages: [
1259
+ {
1260
+ $ref: "#/channels/filler/messages/canton.submitted"
1261
+ }
1262
+ ]
1192
1263
  }
1193
1264
  },
1194
1265
  components: {
@@ -1967,12 +2038,12 @@ var asyncapi_default = {
1967
2038
  id: "g-sa-1",
1968
2039
  fillerId: "acme-markets",
1969
2040
  sentAt: 179000016e4,
1970
- orderHash: "0x585ec61a0813109803da9d47aea37a165f7df1371553f1e4ea8c139cf74058a6",
2041
+ orderHash: "0x65f9010d612499d381eefba1a2385b76982c9bdaf9ed15bedbafd7b09fb3b73b",
1971
2042
  attempt: 0,
1972
2043
  sourceChainId: "eip155:11155111",
1973
2044
  proof: {
1974
2045
  kind: 1,
1975
- orderHash: "0x585ec61a0813109803da9d47aea37a165f7df1371553f1e4ea8c139cf74058a6",
2046
+ orderHash: "0x65f9010d612499d381eefba1a2385b76982c9bdaf9ed15bedbafd7b09fb3b73b",
1976
2047
  destination: "0x0000000000000000000000000000000000000000000000000000000000066eee",
1977
2048
  fillRef: "0xfc4cba975d6b96ed2be00adae2d970f61413b963279089dcfc6402ddccc42740",
1978
2049
  recipient: "0x000000000000000000000000742d35cc6634c0532925a3b844bc454e4438f44e",
@@ -1987,17 +2058,17 @@ var asyncapi_default = {
1987
2058
  signatures: [
1988
2059
  {
1989
2060
  signer: "0x5e877d05b3bfef8b53a59dde76b911fb521415cd",
1990
- signature: "0x4efcf401d43002b059a1bf5f12a1a6c868a1917a533cb2df79022845bd8704da1d5a6a67e206d057e29bd06efc19fef0afcc0ece462e732268da4cedb57e4c321c"
2061
+ signature: "0x280a1c67572079434e423c51ee29272a0afb87bc485b3292192fb08242aeef687bcd1417aff35025ab16da3f43a73972585877b131a2b4dfe83d1ae4f5ef0fad1b"
1991
2062
  },
1992
2063
  {
1993
2064
  signer: "0x6805cf7ce01e1c392d47806813503e367c932544",
1994
- signature: "0x29a0148c3a5cdcadf63a4aaef763784751a3fa6064dc276330227729ddbc69015ea1efdab546cf1552ca726de9ccf4480e8d5ff3c3ed9b718c4964b5bc03ddcf1c"
2065
+ signature: "0x77cba7cedee87b88ac9d90ce0440bb55fa510930318e1a7cb9e2567f198208fb3784a5ca3343c3df2d7dfc29b0a2eae3b87b475893b4d134fa6ce9d8df2a88521b"
1995
2066
  }
1996
2067
  ],
1997
2068
  setId: 1,
1998
2069
  threshold: 2,
1999
2070
  refundAfter: "1790002400",
2000
- sig: "0x1d81fa8e56999d9bf8365f2aa18025291198a51b769dcddd7ebaaa3b61eca32f262f218caf2618bc8b351c65eca89417defeb5f3905f7327a68e9cdd1d29f99d1b"
2071
+ sig: "0x703468572b0f0d056f7c8547a2a70dbb76469888d23059926e906d23cc0468ac54cd96efe6a0f298750a225cd4a7e6acb511f144631076ed2825de0bf0e40b1e1b"
2001
2072
  }
2002
2073
  },
2003
2074
  {
@@ -2005,21 +2076,21 @@ var asyncapi_default = {
2005
2076
  payload: {
2006
2077
  type: "settle.attestations",
2007
2078
  id: "g-sa-3",
2008
- fillerId: "cancore-reserve",
2079
+ fillerId: "acme",
2009
2080
  sentAt: 178999976e4,
2010
- orderHash: "0x770f1ebba8ab5b96e3efbed39c0f630d56f934f9f232771abaccdb0cf17ca204",
2081
+ orderHash: "0x22e3a53ab72c6990b1971fd50b9ec6c527a003d987cd58d26058b380dd7ae79a",
2011
2082
  attempt: 1,
2012
2083
  sourceChainId: "canton:mainnet",
2013
2084
  proof: {
2014
2085
  kind: 1,
2015
- orderHash: "0x770f1ebba8ab5b96e3efbed39c0f630d56f934f9f232771abaccdb0cf17ca204",
2086
+ orderHash: "0x22e3a53ab72c6990b1971fd50b9ec6c527a003d987cd58d26058b380dd7ae79a",
2016
2087
  destination: "0x0000000000000000000000000000000000000000000000000000000000000001",
2017
2088
  fillRef: "0xfba8fd8a079872a9efe9646fcf34cfbbe8711ebd63665e8f2e0924949264c471",
2018
2089
  recipient: "0x000000000000000000000000742d35cc6634c0532925a3b844bc454e4438f44e",
2019
2090
  outputAsset: "0x000000000000000000000000a0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
2020
2091
  amountDelivered: "1200250000",
2021
2092
  filledAt: "1789999700",
2022
- fillerId: "0xe3a8297b35498225c7903ca1a305ef64fcd783cf42c6c687b7b332c83d4dd837",
2093
+ fillerId: "0xe29dae06ef4c3e336b7538b6d4f52ca1ecec009b1df6fb501320e11b223aeeaf",
2023
2094
  repayTo: "0x4fa94ace29856f88ebea07ce6d18e21f52c60b4f66d147134c03c82b62957f9d",
2024
2095
  attempt: 1,
2025
2096
  setId: 3
@@ -2028,23 +2099,289 @@ var asyncapi_default = {
2028
2099
  {
2029
2100
  signer: "0x5e877d05b3bfef8b53a59dde76b911fb521415cd",
2030
2101
  pubKey: "0x3056301006072a8648ce3d020106052b8104000a034200046e4ce4835ad9bacce317724d5a85bfb72f73c0e0e0d9bb0ece443a23c405994056f031b0c83296033a1fd06fc21cbfdab8a821b09c0172ed64ef1b1ee3469be3",
2031
- signature: "0x3045022100a7554c31e432a90ae7384910ae3f9128b41034769dd072319fcf8131bb8062b1022006ac576ed5858c881238334835d35f5aacb765b16842a3f926a540355997883e"
2102
+ signature: "0x3044022048f14c61c1f52f541ab136ef92bbbcfca14dd0560db802feb510f7fce19477b20220230a636d4d10c7e5c16b997394a8261185a899f0e8d8e5ffad14db4d4123dd16"
2032
2103
  },
2033
2104
  {
2034
2105
  signer: "0x6805cf7ce01e1c392d47806813503e367c932544",
2035
2106
  pubKey: "0x3056301006072a8648ce3d020106052b8104000a034200044f15010d9f9457006502d7cbe0cfc5ed67076c2d6f2d4d034b8412e1c07561c370356c5da930ec7a271c3c8d11d00a14e36a3cd3a2a4fad8c05b367357f15b7e",
2036
- signature: "0x3044022035cdea625125d6b555d9ab2405afb085c1d9a65d780048e607ace4f78740f5fc02207d4236924fd1e29bdc1576077c56da025ebfe63ed0c13bb720baa9ed4a444a93"
2107
+ signature: "0x3045022100d4cb2f8a3084bf5749871a06fa543a9ba80889471eb2799ab4c4c08b31ee7e2902203e2b4af4e08f263168a046a4b6a6370398c7b03de7797f1a011910c0d784f4bc"
2037
2108
  },
2038
2109
  {
2039
2110
  signer: "0x695ba7eb3c2a35bfc8d16562560a01ba1f9931d0",
2040
2111
  pubKey: "0x3056301006072a8648ce3d020106052b8104000a0342000479d89465d2de95e32eb728c63c58f4554dbecd39dacf7b680a326672cbc601af2abda0dd84f5b8a4bf8efebcb5eb0d24643dc0cc32af3f76a6ef877b71e19e2b",
2041
- signature: "0x3045022100b4523bba8213ce348a7334680f4b3c54bfa3b815c907993415a43dc54452cb0e02201fc0f93a9199dfe16f3aff06684146bf6f28ff1df5efea5d874b3d877051678b"
2112
+ signature: "0x304402200a300c658594fe20fb429c4f32e23e0b3e444a017f320622cb636792d6f13ca802200cbd9bcb4ea5719f63f8a510e7e9f3d730a47691a7b6eb8e78ec787218997e02"
2042
2113
  }
2043
2114
  ],
2044
2115
  setId: 3,
2045
2116
  threshold: 2,
2046
2117
  refundAfter: "1790001800",
2047
- sig: "0x31ef2d7b9fb10cc97215e965e9cc866e6e595ba92d9f630a00fbaedc3241399f0d65b0e75c81504ba0989eb4264e55e46b571bd7252f45699ab4792d40e5ca931b"
2118
+ sig: "0x481041cd0c07174f6db63b7acdc96a0bcc399de0be60df07faea3be6f0f09c83553a59f5e5443a6d7d1763789404d732a4b5cdc57758b729adf50245b8f96c2d1b"
2119
+ }
2120
+ }
2121
+ ]
2122
+ },
2123
+ "canton.prepare": {
2124
+ name: "canton.prepare",
2125
+ title: "canton.prepare (F2S)",
2126
+ payload: {
2127
+ schemaFormat: "application/schema+json;version=draft-2020-12",
2128
+ schema: {
2129
+ $ref: "messages.schema.json#/$defs/canton.prepare"
2130
+ }
2131
+ },
2132
+ examples: [
2133
+ {
2134
+ name: "canton-prepare-1",
2135
+ payload: {
2136
+ type: "canton.prepare",
2137
+ id: "cp-1",
2138
+ fillerId: "acme-markets",
2139
+ sentAt: 178999e7,
2140
+ msgSig: "0x000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001b",
2141
+ op: "party.allocate",
2142
+ params: {
2143
+ publicKey: "0x1111111111111111111111111111111111111111111111111111111111111111"
2144
+ }
2145
+ }
2146
+ },
2147
+ {
2148
+ name: "canton-prepare-2",
2149
+ payload: {
2150
+ type: "canton.prepare",
2151
+ id: "cp-2",
2152
+ fillerId: "acme-markets",
2153
+ sentAt: 17899901e5,
2154
+ msgSig: "0x000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001b",
2155
+ op: "registry.accept",
2156
+ params: {}
2157
+ }
2158
+ },
2159
+ {
2160
+ name: "canton-prepare-3",
2161
+ payload: {
2162
+ type: "canton.prepare",
2163
+ id: "cp-3",
2164
+ fillerId: "acme-markets",
2165
+ sentAt: 1790000026e3,
2166
+ msgSig: "0x000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001b",
2167
+ op: "delivery.fill",
2168
+ params: {
2169
+ orderHash: "0x65f9010d612499d381eefba1a2385b76982c9bdaf9ed15bedbafd7b09fb3b73b",
2170
+ attempt: 2
2171
+ }
2172
+ }
2173
+ },
2174
+ {
2175
+ name: "canton-prepare-4",
2176
+ payload: {
2177
+ type: "canton.prepare",
2178
+ id: "cp-4",
2179
+ fillerId: "acme-markets",
2180
+ sentAt: 17900007e5,
2181
+ msgSig: "0x000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001b",
2182
+ op: "intent.settle",
2183
+ params: {
2184
+ orderHash: "0x65f9010d612499d381eefba1a2385b76982c9bdaf9ed15bedbafd7b09fb3b73b"
2185
+ }
2186
+ }
2187
+ },
2188
+ {
2189
+ name: "canton-prepare-5",
2190
+ payload: {
2191
+ type: "canton.prepare",
2192
+ id: "cp-5",
2193
+ fillerId: "acme-markets",
2194
+ sentAt: 1790001e6,
2195
+ msgSig: "0x000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001b",
2196
+ op: "holdings.transfer",
2197
+ params: {
2198
+ asset: {
2199
+ admin: "cancore-registry::1220aa",
2200
+ id: "CNRX"
2201
+ },
2202
+ amount: "250.5",
2203
+ toParty: "alice::1220f0e1d2c3b4a5968778695a4b3c2d1e0ff0e1d2c3b4a5968778695a4b3c2d1e0f"
2204
+ }
2205
+ }
2206
+ }
2207
+ ]
2208
+ },
2209
+ "canton.prepared": {
2210
+ name: "canton.prepared",
2211
+ title: "canton.prepared (S2F)",
2212
+ payload: {
2213
+ schemaFormat: "application/schema+json;version=draft-2020-12",
2214
+ schema: {
2215
+ $ref: "messages.schema.json#/$defs/canton.prepared"
2216
+ }
2217
+ },
2218
+ examples: [
2219
+ {
2220
+ name: "canton-prepared-1",
2221
+ payload: {
2222
+ type: "canton.prepared",
2223
+ id: "g-19",
2224
+ fillerId: "acme-markets",
2225
+ sig: "0x000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001b",
2226
+ sentAt: 1789990000200,
2227
+ re: "cp-1",
2228
+ operationId: "op-1",
2229
+ op: "party.allocate",
2230
+ legs: [
2231
+ {
2232
+ legId: "topology-0",
2233
+ kind: "topology",
2234
+ hash: "0x12203d71f7c09428bb0f75651436e3a1c92b3a12490049882ff50711337cf5c9de0a",
2235
+ topologyTransactions: [
2236
+ "CgMyLjESBTAuMC4x",
2237
+ "CgMyLjESBTAuMC4y"
2238
+ ]
2239
+ }
2240
+ ],
2241
+ summary: {
2242
+ partyId: "acme-markets::1220a1b2c3d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f60718293a4b5c6d7e8f90",
2243
+ publicKey: "0x1111111111111111111111111111111111111111111111111111111111111111",
2244
+ hosting: {
2245
+ participantUid: "PAR::cancore::1220c0ffee",
2246
+ permission: "CONFIRMATION",
2247
+ threshold: 1
2248
+ }
2249
+ },
2250
+ expiresAt: 1789990300200
2251
+ }
2252
+ },
2253
+ {
2254
+ name: "canton-prepared-2",
2255
+ payload: {
2256
+ type: "canton.prepared",
2257
+ id: "g-20",
2258
+ fillerId: "acme-markets",
2259
+ sig: "0x000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001b",
2260
+ sentAt: 1790000026300,
2261
+ re: "cp-3",
2262
+ operationId: "op-3",
2263
+ op: "delivery.fill",
2264
+ legs: [
2265
+ {
2266
+ legId: "delivery-fill-0",
2267
+ kind: "transaction",
2268
+ hash: "0xf85381267321fc9b5122e45db048de3313dbc0dce8b36202673245d6c6d92840",
2269
+ preparedTransaction: "CgMyLjESBTAuMC4x",
2270
+ hashingSchemeVersion: "HASHING_SCHEME_VERSION_V2"
2271
+ }
2272
+ ],
2273
+ summary: {
2274
+ orderHash: "0x65f9010d612499d381eefba1a2385b76982c9bdaf9ed15bedbafd7b09fb3b73b",
2275
+ attempt: 2,
2276
+ deliveryOrderCid: "00a1b2c3d4e5f6#fixture-delivery-order",
2277
+ recipient: "alice::1220f0e1d2c3b4a5968778695a4b3c2d1e0ff0e1d2c3b4a5968778695a4b3c2d1e0f",
2278
+ asset: {
2279
+ admin: "cancore-registry::1220aa",
2280
+ id: "CNRX"
2281
+ },
2282
+ amount: "999.0",
2283
+ repayTo: "0x0000000000000000000000003c44cdddb6a900fa2b585dd299e03d12fa4293bc",
2284
+ validUntil: "1790000400",
2285
+ inputHoldingCids: [
2286
+ "00h1",
2287
+ "00h2"
2288
+ ],
2289
+ executeBefore: "1790000400",
2290
+ transferFactoryCid: "00tf"
2291
+ },
2292
+ expiresAt: 1790000326300
2293
+ }
2294
+ }
2295
+ ]
2296
+ },
2297
+ "canton.submit": {
2298
+ name: "canton.submit",
2299
+ title: "canton.submit (F2S)",
2300
+ payload: {
2301
+ schemaFormat: "application/schema+json;version=draft-2020-12",
2302
+ schema: {
2303
+ $ref: "messages.schema.json#/$defs/canton.submit"
2304
+ }
2305
+ },
2306
+ examples: [
2307
+ {
2308
+ name: "canton-submit-1",
2309
+ payload: {
2310
+ type: "canton.submit",
2311
+ id: "cs-3",
2312
+ fillerId: "acme-markets",
2313
+ sentAt: 1790000027e3,
2314
+ msgSig: "0x000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001b",
2315
+ operationId: "op-3",
2316
+ signatures: [
2317
+ {
2318
+ legId: "delivery-fill-0",
2319
+ signature: "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000"
2320
+ }
2321
+ ]
2322
+ }
2323
+ }
2324
+ ]
2325
+ },
2326
+ "canton.submitted": {
2327
+ name: "canton.submitted",
2328
+ title: "canton.submitted (S2F)",
2329
+ payload: {
2330
+ schemaFormat: "application/schema+json;version=draft-2020-12",
2331
+ schema: {
2332
+ $ref: "messages.schema.json#/$defs/canton.submitted"
2333
+ }
2334
+ },
2335
+ examples: [
2336
+ {
2337
+ name: "canton-submitted-1",
2338
+ payload: {
2339
+ type: "canton.submitted",
2340
+ id: "g-21",
2341
+ fillerId: "acme-markets",
2342
+ sig: "0x000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001b",
2343
+ sentAt: 1790000029e3,
2344
+ re: "cs-3",
2345
+ operationId: "op-3",
2346
+ op: "delivery.fill",
2347
+ updateId: "1220ab0c",
2348
+ result: {
2349
+ receiptCid: "00c1d2"
2350
+ }
2351
+ }
2352
+ },
2353
+ {
2354
+ name: "canton-submitted-2",
2355
+ payload: {
2356
+ type: "canton.submitted",
2357
+ id: "g-22",
2358
+ fillerId: "acme-markets",
2359
+ sig: "0x000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001b",
2360
+ sentAt: 1789990002e3,
2361
+ re: "cs-1",
2362
+ operationId: "op-1",
2363
+ op: "party.allocate",
2364
+ result: {
2365
+ partyId: "acme-markets::1220a1b2c3d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f60718293a4b5c6d7e8f90"
2366
+ }
2367
+ }
2368
+ },
2369
+ {
2370
+ name: "canton-submitted-3",
2371
+ payload: {
2372
+ type: "canton.submitted",
2373
+ id: "g-23",
2374
+ fillerId: "acme-markets",
2375
+ sig: "0x000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001b",
2376
+ sentAt: 1790001002e3,
2377
+ re: "cs-5",
2378
+ operationId: "op-5",
2379
+ op: "holdings.transfer",
2380
+ updateId: "1220ab0d",
2381
+ result: {
2382
+ outcome: "PENDING",
2383
+ transferInstructionCid: "00ti"
2384
+ }
2048
2385
  }
2049
2386
  }
2050
2387
  ]
@@ -2128,7 +2465,7 @@ var messages_schema_default = {
2128
2465
  },
2129
2466
  errorCode: {
2130
2467
  anyOf: [
2131
- { enum: ["BAD_REQUEST", "UNAUTHENTICATED", "UNSUPPORTED_VERSION", "UNSUPPORTED_TYPE", "BAD_SIGNATURE", "STALE_MESSAGE", "REPLAYED_MESSAGE", "TICKET_REFUSED", "UNKNOWN_REQUEST", "UNKNOWN_TICKET", "TICKET_CLOSED", "NOT_ELIGIBLE", "RATE_LIMITED", "INTERNAL", "ATTESTATIONS_NOT_READY"] },
2468
+ { enum: ["BAD_REQUEST", "UNAUTHENTICATED", "UNSUPPORTED_VERSION", "UNSUPPORTED_TYPE", "BAD_SIGNATURE", "STALE_MESSAGE", "REPLAYED_MESSAGE", "TICKET_REFUSED", "UNKNOWN_REQUEST", "UNKNOWN_TICKET", "TICKET_CLOSED", "NOT_ELIGIBLE", "RATE_LIMITED", "INTERNAL", "ATTESTATIONS_NOT_READY", "CANTON_NOT_READY", "CANTON_REFUSED", "CANTON_UNAVAILABLE", "OPERATION_EXPIRED"] },
2132
2469
  { $ref: "#/$defs/futureEnumValue" }
2133
2470
  ]
2134
2471
  },
@@ -2594,6 +2931,369 @@ var messages_schema_default = {
2594
2931
  threshold: { type: "integer", minimum: 1, maximum: 4294967295, description: "k of that set" },
2595
2932
  refundAfter: { $ref: "#/$defs/timeS", description: "from this time settle reverts; the node gets its settle included before it" }
2596
2933
  }
2934
+ },
2935
+ cantonOp: {
2936
+ description: "A Canton operation of the filler's own external party on the Cancore participant (protocol \xA73.19): the backend prepares and submits it, the node signs it with its party key and never talks to a Ledger API. party.allocate creates the party (topology); registry.accept accepts the FillerRegistryEntryProposal of the fillerId; delivery.fill exercises DeliveryOrder_Fill of a Canton ticket issued to the filler; intent.settle exercises SwapIntent_SettleWithProof of a Canton-source order the filler delivered; holdings.transfer moves the party's own holdings to a party it names (TransferFactory_Transfer)",
2937
+ anyOf: [
2938
+ { enum: ["party.allocate", "registry.accept", "delivery.fill", "intent.settle", "holdings.transfer"] },
2939
+ { type: "string", pattern: "^[a-z][a-z0-9-]*(\\.[a-z][a-z0-9-]*)+$" }
2940
+ ]
2941
+ },
2942
+ operationId: {
2943
+ type: "string",
2944
+ pattern: "^[!-~]{1,64}$",
2945
+ description: "the handle canton.prepared hands out for canton.submit: opaque, 1..64 printable ASCII, valid until expiresAt"
2946
+ },
2947
+ edPublicKey: { type: "string", pattern: "^0x[0-9a-f]{64}$", description: "the raw 32-byte Ed25519 public key of the filler's Canton party, lowercase hex" },
2948
+ edSignature: { type: "string", pattern: "^0x[0-9a-f]{128}$", description: "64-byte Ed25519 signature by the party key over the bytes of a leg's hash, lowercase hex" },
2949
+ cantonLegTransaction: {
2950
+ type: "object",
2951
+ description: "A prepared Canton transaction to sign. MUST before signing (protocol \xA73.19): the node recomputes `hash` from `preparedTransaction` with the participant's prepared-transaction hashing of `hashingSchemeVersion`, decodes the transaction and checks it against `summary` for the op of the message \u2014 template and choice, acting and receiving parties, instrument, amount; on any difference it does not sign. It signs the 32 hash bytes with its party key",
2952
+ required: ["legId", "kind", "hash", "preparedTransaction", "hashingSchemeVersion"],
2953
+ properties: {
2954
+ legId: { type: "string", minLength: 1, maxLength: 128 },
2955
+ kind: { const: "transaction" },
2956
+ hash: { type: "string", pattern: "^0x[0-9a-f]{64}$", description: "the 32-byte prepared-transaction hash" },
2957
+ preparedTransaction: {
2958
+ type: "string",
2959
+ minLength: 1,
2960
+ pattern: "^[A-Za-z0-9+/]+={0,2}$",
2961
+ description: "the prepared transaction (base64 protobuf) the hash is over. Never logged"
2962
+ },
2963
+ hashingSchemeVersion: {
2964
+ type: "string",
2965
+ pattern: "^HASHING_SCHEME_VERSION_V[0-9]+$",
2966
+ description: "the participant's prepared-transaction hashing scheme the hash was computed with"
2967
+ }
2968
+ }
2969
+ },
2970
+ cantonLegTopology: {
2971
+ type: "object",
2972
+ description: "The onboarding topology of the filler's party, in `party.allocate` only (a topology leg in any other op is refused by the schema). MUST before signing (protocol \xA73.19): the node recomputes the multihash over `topologyTransactions` and checks that they create the party of `summary.partyId` with the key of `summary.publicKey` as its only signing key, hosted on the Cancore participant; on any difference it does not sign. It signs the 34 multihash bytes with its party key",
2973
+ required: ["legId", "kind", "hash", "topologyTransactions"],
2974
+ properties: {
2975
+ legId: { type: "string", minLength: 1, maxLength: 128 },
2976
+ kind: { const: "topology" },
2977
+ hash: { type: "string", pattern: "^0x1220[0-9a-f]{64}$", description: "the topology multihash: 0x1220 \u2016 sha256" },
2978
+ topologyTransactions: {
2979
+ type: "array",
2980
+ minItems: 1,
2981
+ items: { type: "string", minLength: 1, pattern: "^[A-Za-z0-9+/]+={0,2}$" },
2982
+ description: "the topology transactions (base64 protobuf) the multihash is over, in order"
2983
+ }
2984
+ }
2985
+ },
2986
+ cantonSignature: {
2987
+ type: "object",
2988
+ required: ["legId", "signature"],
2989
+ properties: { legId: { type: "string", minLength: 1, maxLength: 128 }, signature: { $ref: "#/$defs/edSignature" } }
2990
+ },
2991
+ "canton.prepare": {
2992
+ "x-direction": "F2S",
2993
+ type: "object",
2994
+ description: "Prepare a Canton operation of the sender's own party (\xA73.19); answered by canton.prepared (re = this id) or error. params select the operation only: the backend picks every contract itself (holdings, delivery order, intent, registry entry, disclosed contracts, attestor signatures). Admission: party.allocate \u2014 the fillerId has no party yet, or this key's party; registry.accept \u2014 a proposal for the fillerId and its party is live; delivery.fill \u2014 an ISSUED Canton ticket of this filler for (orderHash, attempt), before validUntil; intent.settle \u2014 a Canton-source order this filler delivered, with attestations held; holdings.transfer \u2014 enough unlocked holdings of the asset beyond what the party's open delivery orders need, to a party other than its own. Each prepare prepares afresh and replaces the filler's open operation of the same op and target",
2995
+ allOf: [
2996
+ { $ref: "#/$defs/f2sBase" },
2997
+ {
2998
+ if: { type: "object", properties: { op: { const: "party.allocate" } }, required: ["op"] },
2999
+ then: {
3000
+ type: "object",
3001
+ required: ["params"],
3002
+ properties: { params: { type: "object", required: ["publicKey"], properties: { publicKey: { $ref: "#/$defs/edPublicKey" } } } }
3003
+ }
3004
+ },
3005
+ {
3006
+ if: { type: "object", properties: { op: { const: "registry.accept" } }, required: ["op"] },
3007
+ then: { type: "object", required: ["params"], properties: { params: { type: "object" } } }
3008
+ },
3009
+ {
3010
+ if: { type: "object", properties: { op: { const: "delivery.fill" } }, required: ["op"] },
3011
+ then: {
3012
+ type: "object",
3013
+ required: ["params"],
3014
+ properties: {
3015
+ params: {
3016
+ type: "object",
3017
+ required: ["orderHash", "attempt"],
3018
+ properties: { orderHash: { $ref: "#/$defs/bytes32" }, attempt: { $ref: "#/$defs/uint32" } }
3019
+ }
3020
+ }
3021
+ }
3022
+ },
3023
+ {
3024
+ if: { type: "object", properties: { op: { const: "intent.settle" } }, required: ["op"] },
3025
+ then: {
3026
+ type: "object",
3027
+ required: ["params"],
3028
+ properties: { params: { type: "object", required: ["orderHash"], properties: { orderHash: { $ref: "#/$defs/bytes32" } } } }
3029
+ }
3030
+ },
3031
+ {
3032
+ if: { type: "object", properties: { op: { const: "holdings.transfer" } }, required: ["op"] },
3033
+ then: {
3034
+ type: "object",
3035
+ required: ["params"],
3036
+ properties: {
3037
+ params: {
3038
+ type: "object",
3039
+ required: ["asset", "amount", "toParty"],
3040
+ properties: {
3041
+ asset: { $ref: "#/$defs/cantonAsset" },
3042
+ amount: { type: "string", pattern: "^(0|[1-9][0-9]*)(\\.[0-9]{1,10})?$", description: "Daml Decimal, > 0" },
3043
+ toParty: { type: "string", minLength: 1, maxLength: 255, description: "the receiving Canton party; never the filler's own" }
3044
+ }
3045
+ }
3046
+ }
3047
+ }
3048
+ }
3049
+ ],
3050
+ required: ["type", "op", "params"],
3051
+ properties: { type: { const: "canton.prepare" }, op: { $ref: "#/$defs/cantonOp" }, params: { type: "object" } }
3052
+ },
3053
+ "canton.prepared": {
3054
+ "x-direction": "S2F",
3055
+ type: "object",
3056
+ description: "A prepared operation. The node MUST verify every leg before it signs it (cantonLegTransaction, cantonLegTopology): what it signs is what Cancore assembled, and summary is only what Cancore says about it \u2014 a leg that does not match summary, or summary that does not match what the node expects of the op, is not signed. Topology legs come with party.allocate only; every other op prepares transactions. Then the node signs every leg's hash with its party key and sends canton.submit before expiresAt. An operationId stays valid until its own expiresAt whatever is prepared after it",
3057
+ allOf: [
3058
+ { $ref: "#/$defs/s2fBase" },
3059
+ {
3060
+ if: { type: "object", properties: { op: { const: "party.allocate" } }, required: ["op"] },
3061
+ then: { type: "object", properties: { legs: { type: "array", items: { $ref: "#/$defs/cantonLegTopology" } } } },
3062
+ else: { type: "object", properties: { legs: { type: "array", items: { $ref: "#/$defs/cantonLegTransaction" } } } }
3063
+ },
3064
+ {
3065
+ if: { type: "object", properties: { op: { const: "party.allocate" } }, required: ["op"] },
3066
+ then: {
3067
+ type: "object",
3068
+ required: ["summary"],
3069
+ properties: {
3070
+ summary: {
3071
+ type: "object",
3072
+ required: ["partyId", "publicKey", "hosting"],
3073
+ properties: {
3074
+ partyId: { type: "string", minLength: 1 },
3075
+ publicKey: { $ref: "#/$defs/edPublicKey" },
3076
+ hosting: {
3077
+ type: "object",
3078
+ required: ["participantUid", "permission", "threshold"],
3079
+ description: "how the topology hosts the party: on the Cancore participant alone, with Confirmation permission, threshold 1 \u2014 the node checks the decoded topology against it",
3080
+ properties: { participantUid: { type: "string", minLength: 1 }, permission: { const: "CONFIRMATION" }, threshold: { const: 1 } }
3081
+ }
3082
+ }
3083
+ }
3084
+ }
3085
+ }
3086
+ },
3087
+ {
3088
+ if: { type: "object", properties: { op: { const: "registry.accept" } }, required: ["op"] },
3089
+ then: {
3090
+ type: "object",
3091
+ required: ["summary"],
3092
+ properties: {
3093
+ summary: {
3094
+ type: "object",
3095
+ required: ["fillerId", "party", "operator", "proposalCid"],
3096
+ properties: {
3097
+ fillerId: { $ref: "#/$defs/fillerId" },
3098
+ party: { type: "string", minLength: 1 },
3099
+ operator: { type: "string", minLength: 1 },
3100
+ proposalCid: { type: "string", minLength: 1 }
3101
+ }
3102
+ }
3103
+ }
3104
+ }
3105
+ },
3106
+ {
3107
+ if: { type: "object", properties: { op: { const: "delivery.fill" } }, required: ["op"] },
3108
+ then: {
3109
+ type: "object",
3110
+ required: ["summary"],
3111
+ properties: {
3112
+ summary: {
3113
+ type: "object",
3114
+ required: [
3115
+ "orderHash",
3116
+ "attempt",
3117
+ "deliveryOrderCid",
3118
+ "recipient",
3119
+ "asset",
3120
+ "amount",
3121
+ "repayTo",
3122
+ "validUntil",
3123
+ "inputHoldingCids",
3124
+ "executeBefore",
3125
+ "transferFactoryCid"
3126
+ ],
3127
+ properties: {
3128
+ orderHash: { $ref: "#/$defs/bytes32" },
3129
+ attempt: { $ref: "#/$defs/uint32" },
3130
+ deliveryOrderCid: { type: "string", minLength: 1 },
3131
+ recipient: { type: "string", minLength: 1, description: "the Canton party the order delivers to" },
3132
+ asset: { $ref: "#/$defs/cantonAsset" },
3133
+ amount: { type: "string", pattern: "^(0|[1-9][0-9]*)(\\.[0-9]{1,10})?$", description: "DeliveryOrder.amount, Daml Decimal" },
3134
+ repayTo: { $ref: "#/$defs/repayTo" },
3135
+ validUntil: { $ref: "#/$defs/timeS" },
3136
+ inputHoldingCids: {
3137
+ type: "array",
3138
+ minItems: 1,
3139
+ items: { type: "string", minLength: 1 },
3140
+ description: "the party's holdings the transfer spends; whatever they hold beyond amount comes back as change"
3141
+ },
3142
+ executeBefore: { $ref: "#/$defs/timeS", description: "the transfer's executeBefore: the order's fillDeadline" },
3143
+ transferFactoryCid: { type: "string", minLength: 1, description: "the registry factory the order pins" }
3144
+ }
3145
+ }
3146
+ }
3147
+ }
3148
+ },
3149
+ {
3150
+ if: { type: "object", properties: { op: { const: "intent.settle" } }, required: ["op"] },
3151
+ then: {
3152
+ type: "object",
3153
+ required: ["summary"],
3154
+ properties: {
3155
+ summary: {
3156
+ type: "object",
3157
+ required: ["orderHash", "intentCid", "asset", "amount", "executeBefore", "payee", "giveAmount", "fee"],
3158
+ properties: {
3159
+ orderHash: { $ref: "#/$defs/bytes32" },
3160
+ intentCid: { type: "string", minLength: 1 },
3161
+ asset: { $ref: "#/$defs/cantonAsset" },
3162
+ amount: {
3163
+ type: "string",
3164
+ pattern: "^(0|[1-9][0-9]*)(\\.[0-9]{1,10})?$",
3165
+ description: "what the settlement pays the payee: giveAmount less fee.amount, Daml Decimal"
3166
+ },
3167
+ executeBefore: { $ref: "#/$defs/timeS" },
3168
+ payee: { type: "string", minLength: 1, description: "the party paid: the filler's own" },
3169
+ giveAmount: { type: "string", pattern: "^(0|[1-9][0-9]*)(\\.[0-9]{1,10})?$", description: "the intent's committed give, fee-inclusive" },
3170
+ fee: {
3171
+ type: "object",
3172
+ required: ["receiver", "amount"],
3173
+ properties: {
3174
+ receiver: { type: "string", minLength: 1, description: "the operator party" },
3175
+ amount: { type: "string", pattern: "^(0|[1-9][0-9]*)(\\.[0-9]{1,10})?$" }
3176
+ },
3177
+ description: "the settlement's fee leg; amount 0 when there is none"
3178
+ }
3179
+ }
3180
+ }
3181
+ }
3182
+ }
3183
+ },
3184
+ {
3185
+ if: { type: "object", properties: { op: { const: "holdings.transfer" } }, required: ["op"] },
3186
+ then: {
3187
+ type: "object",
3188
+ required: ["summary"],
3189
+ properties: {
3190
+ summary: {
3191
+ type: "object",
3192
+ required: ["asset", "amount", "receiver", "inputHoldingCids", "executeBefore"],
3193
+ properties: {
3194
+ asset: { $ref: "#/$defs/cantonAsset" },
3195
+ amount: { type: "string", pattern: "^(0|[1-9][0-9]*)(\\.[0-9]{1,10})?$" },
3196
+ receiver: { type: "string", minLength: 1 },
3197
+ inputHoldingCids: {
3198
+ type: "array",
3199
+ minItems: 1,
3200
+ items: { type: "string", minLength: 1 },
3201
+ description: "the party's holdings the transfer spends; what they hold beyond amount comes back as change"
3202
+ },
3203
+ executeBefore: { $ref: "#/$defs/timeS" }
3204
+ }
3205
+ }
3206
+ }
3207
+ }
3208
+ }
3209
+ ],
3210
+ required: ["type", "re", "operationId", "op", "legs", "summary", "expiresAt"],
3211
+ properties: {
3212
+ type: { const: "canton.prepared" },
3213
+ re: { $ref: "#/$defs/messageId" },
3214
+ operationId: { $ref: "#/$defs/operationId" },
3215
+ op: { $ref: "#/$defs/cantonOp" },
3216
+ legs: { type: "array", minItems: 1 },
3217
+ summary: { type: "object" },
3218
+ expiresAt: { $ref: "#/$defs/timeMs" }
3219
+ }
3220
+ },
3221
+ "canton.submit": {
3222
+ "x-direction": "F2S",
3223
+ type: "object",
3224
+ description: "Submit a prepared operation: one party-key signature per leg. Idempotent per operationId: a repeat (after a lost answer or CANTON_UNAVAILABLE) is answered with the same canton.submitted and never executes twice. OPERATION_EXPIRED: prepare again",
3225
+ allOf: [{ $ref: "#/$defs/f2sBase" }],
3226
+ required: ["type", "operationId", "signatures"],
3227
+ properties: {
3228
+ type: { const: "canton.submit" },
3229
+ operationId: { $ref: "#/$defs/operationId" },
3230
+ signatures: { type: "array", minItems: 1, items: { $ref: "#/$defs/cantonSignature" } }
3231
+ }
3232
+ },
3233
+ "canton.submitted": {
3234
+ "x-direction": "S2F",
3235
+ type: "object",
3236
+ description: "The operation committed. updateId is its Canton update (absent for party.allocate, a topology change); result names what it created, by op",
3237
+ allOf: [
3238
+ { $ref: "#/$defs/s2fBase" },
3239
+ {
3240
+ if: { type: "object", properties: { op: { const: "party.allocate" } }, required: ["op"] },
3241
+ then: {
3242
+ type: "object",
3243
+ required: ["result"],
3244
+ properties: { result: { type: "object", required: ["partyId"], properties: { partyId: { type: "string", minLength: 1 } } } }
3245
+ }
3246
+ },
3247
+ {
3248
+ if: { type: "object", properties: { op: { const: "registry.accept" } }, required: ["op"] },
3249
+ then: {
3250
+ type: "object",
3251
+ required: ["result"],
3252
+ properties: { result: { type: "object", required: ["entryCid"], properties: { entryCid: { type: "string", minLength: 1 } } } }
3253
+ }
3254
+ },
3255
+ {
3256
+ if: { type: "object", properties: { op: { const: "delivery.fill" } }, required: ["op"] },
3257
+ then: {
3258
+ type: "object",
3259
+ required: ["result"],
3260
+ properties: { result: { type: "object", required: ["receiptCid"], properties: { receiptCid: { type: "string", minLength: 1 } } } }
3261
+ }
3262
+ },
3263
+ {
3264
+ if: { type: "object", properties: { op: { const: "intent.settle" } }, required: ["op"] },
3265
+ then: { type: "object", required: ["result"], properties: { result: { type: "object" } } }
3266
+ },
3267
+ {
3268
+ if: { type: "object", properties: { op: { const: "holdings.transfer" } }, required: ["op"] },
3269
+ then: {
3270
+ type: "object",
3271
+ required: ["result"],
3272
+ properties: {
3273
+ result: {
3274
+ type: "object",
3275
+ required: ["outcome"],
3276
+ properties: {
3277
+ outcome: {
3278
+ anyOf: [{ enum: ["COMPLETED", "PENDING"] }, { $ref: "#/$defs/futureEnumValue" }],
3279
+ description: "COMPLETED: the receiver holds it (a preapproval accepted it); PENDING: a TransferInstruction waits for the receiver to accept"
3280
+ },
3281
+ transferInstructionCid: { type: "string", minLength: 1, description: "with PENDING" }
3282
+ }
3283
+ }
3284
+ }
3285
+ }
3286
+ }
3287
+ ],
3288
+ required: ["type", "re", "operationId", "op", "result"],
3289
+ properties: {
3290
+ type: { const: "canton.submitted" },
3291
+ re: { $ref: "#/$defs/messageId" },
3292
+ operationId: { $ref: "#/$defs/operationId" },
3293
+ op: { $ref: "#/$defs/cantonOp" },
3294
+ updateId: { type: "string", minLength: 1 },
3295
+ result: { type: "object" }
3296
+ }
2597
3297
  }
2598
3298
  }
2599
3299
  };
@@ -2699,7 +3399,7 @@ var rest_schema_default = {
2699
3399
  $schema: "https://json-schema.org/draft/2020-12/schema",
2700
3400
  $id: "https://cancore.io/schemas/filler-protocol/v1/rest.schema.json",
2701
3401
  title: "Cancore filler protocol v1 \u2014 REST fallback",
2702
- $comment: "protocol \xA73.6. Bodies are the WebSocket frames: every request body is a filler message with its envelope (id, fillerId, sentAt) and msgSig, verified before processing as on the WebSocket (S-19); every response is a freshly signed S\u2192F message. Login: GET /v1/filler/auth/challenge?fillerId= returns a signed auth.challenge addressed to that fillerId; POST /v1/filler/auth with the auth.response (FillerAuth over it) returns {token, expiresAt}. The challenge route is anonymous and its refusals are UNSIGNED (unsignedErrorBody, no sig, nothing journalled): 400 BAD_REQUEST \u2014 fillerId missing or not a fillerId; 404 UNKNOWN_REQUEST \u2014 fillerId unknown or not ACTIVE; the anonymous login steps are charged to no fillerId's rate limits (knowing a fillerId cannot lock its filler out); a 429 here comes only from the per-IP limit in front of filler-gateway. POST /v1/filler/auth refuses UNSIGNED too as long as it has checked no signature: 400 BAD_REQUEST \u2014 no or a malformed fillerId; 404 UNKNOWN_REQUEST \u2014 fillerId unknown or not ACTIVE; 401 UNAUTHENTICATED \u2014 the fillerId holds no live challenge (evicted, expired or used: ask for a new one). Its refusals after the signature checks (BAD_SIGNATURE, STALE_MESSAGE, REPLAYED_MESSAGE, UNSUPPORTED_VERSION, NOT_ELIGIBLE, UNAUTHENTICATED) are the signed error. The other /v1/filler/* routes need `Authorization: Bearer <token>`; the token is bound to (fillerId, message key) and stops working when it expires, when the message key is changed, or when the filler is no longer ACTIVE. The same token opens the WebSocket (asyncapi.json: offered as the subprotocol bearer.<token>). A ticket of another filler is 404 UNKNOWN_TICKET. Rate limits are per fillerId, shared by REST and every WebSocket session of it: over the limit a bearer route answers 429 with an UNSIGNED unsignedErrorBody {type: error, code: RATE_LIMITED, message, retryAfterMs} and a Retry-After header (seconds, rounded up), journals nothing one by one, and the request changes nothing; during the cooldown after sustained excess every bearer route answers so. Every 429 is unsigned, on every route; a filler decides by the status and takes retryAfterMs (else Retry-After) as a hint. Every other non-2xx of a bearer route is the signed error. GET /v1/filler/attestations/{orderHash} answers 404 ATTESTATIONS_NOT_READY until the gateway holds \u2265 threshold verified signatures for this filler's fill, and 404 UNKNOWN_TICKET when this filler holds no ticket on the order. /v1/draws/* and /v1/gateway are public. Every non-2xx body is the signed `error` frame, with the HTTP status of x-error-status \u2014 except a 429 (always unsignedErrorBody) and the unsigned refusals of an endpoint that names an errorBody. x-endpoints: request/query/response/errorBody name a $def here or in messages.schema.json.",
3402
+ $comment: "protocol \xA73.6. Bodies are the WebSocket frames: every request body is a filler message with its envelope (id, fillerId, sentAt) and msgSig, verified before processing as on the WebSocket (S-19); every response is a freshly signed S\u2192F message. Login: GET /v1/filler/auth/challenge?fillerId= returns a signed auth.challenge addressed to that fillerId; POST /v1/filler/auth with the auth.response (FillerAuth over it) returns {token, expiresAt}. The challenge route is anonymous and its refusals are UNSIGNED (unsignedErrorBody, no sig, nothing journalled): 400 BAD_REQUEST \u2014 fillerId missing or not a fillerId; 404 UNKNOWN_REQUEST \u2014 fillerId unknown or not ACTIVE; the anonymous login steps are charged to no fillerId's rate limits (knowing a fillerId cannot lock its filler out); a 429 here comes only from the per-IP limit in front of filler-gateway. POST /v1/filler/auth refuses UNSIGNED too as long as it has checked no signature: 400 BAD_REQUEST \u2014 no or a malformed fillerId; 404 UNKNOWN_REQUEST \u2014 fillerId unknown or not ACTIVE; 401 UNAUTHENTICATED \u2014 the fillerId holds no live challenge (evicted, expired or used: ask for a new one). Its refusals after the signature checks (BAD_SIGNATURE, STALE_MESSAGE, REPLAYED_MESSAGE, UNSUPPORTED_VERSION, NOT_ELIGIBLE, UNAUTHENTICATED) are the signed error. The other /v1/filler/* routes need `Authorization: Bearer <token>`; the token is bound to (fillerId, message key) and stops working when it expires, when the message key is changed, or when the filler is no longer ACTIVE. The same token opens the WebSocket (asyncapi.json: offered as the subprotocol bearer.<token>). A ticket of another filler is 404 UNKNOWN_TICKET. Rate limits are per fillerId and rate class (quote, ticket, service, read for every bearer GET, login, cantonPrepare for canton.prepare of \xA73.19 \u2014 an hourly budget per filler, 60 by default \u2014 and canton for canton.submit, so a spent prepare budget never holds back the submit of an operation already prepared), shared by REST and every WebSocket session of it: over the limit a bearer route answers 429 with an UNSIGNED unsignedErrorBody {type: error, code: RATE_LIMITED, message, retryAfterMs} and a Retry-After header (seconds, rounded up), journals nothing one by one, and the request changes nothing; during the cooldown after sustained excess every bearer route answers so. Every 429 is unsigned, on every route; a filler decides by the status and takes retryAfterMs (else Retry-After) as a hint. Every other non-2xx of a bearer route is the signed error. GET /v1/filler/attestations/{orderHash} answers 404 ATTESTATIONS_NOT_READY until the gateway holds \u2265 threshold verified signatures for this filler's fill, and 404 UNKNOWN_TICKET when this filler holds no ticket on the order. /v1/filler/canton/* (\xA73.19) serve only the caller's own party: POST prepare and submit take the canton.prepare and canton.submit messages and answer canton.prepared and canton.submitted (the same frames as on the WebSocket); GET party, holdings and delivery-orders read the party registered for the fillerId, and answer 409 CANTON_NOT_READY while it has none. /v1/draws/* and /v1/gateway are public. Every non-2xx body is the signed `error` frame, with the HTTP status of x-error-status \u2014 except a 429 (always unsignedErrorBody) and the unsigned refusals of an endpoint that names an errorBody. x-endpoints: request/query/response/errorBody name a $def here or in messages.schema.json.",
2703
3403
  "x-endpoints": [
2704
3404
  { method: "GET", path: "/v1/filler/auth/challenge", auth: "none", query: "#/$defs/challengeQuery", response: "messages.schema.json#/$defs/auth.challenge", errorBody: "#/$defs/unsignedErrorBody" },
2705
3405
  { method: "POST", path: "/v1/filler/auth", auth: "none", request: "messages.schema.json#/$defs/auth.response", response: "#/$defs/authToken", errorBody: "#/$defs/unsignedErrorBody" },
@@ -2714,7 +3414,12 @@ var rest_schema_default = {
2714
3414
  { method: "GET", path: "/v1/filler/attestations/{orderHash}", auth: "bearer", response: "messages.schema.json#/$defs/settle.attestations" },
2715
3415
  { method: "GET", path: "/v1/draws/{orderHash}", auth: "none", response: "records.schema.json#/$defs/drawRecord" },
2716
3416
  { method: "GET", path: "/v1/draws/epochs/{id}", auth: "none", response: "records.schema.json#/$defs/epochRecord" },
2717
- { method: "GET", path: "/v1/gateway", auth: "none", response: "records.schema.json#/$defs/gatewayInfo" }
3417
+ { method: "GET", path: "/v1/gateway", auth: "none", response: "records.schema.json#/$defs/gatewayInfo" },
3418
+ { method: "POST", path: "/v1/filler/canton/prepare", auth: "bearer", request: "messages.schema.json#/$defs/canton.prepare", response: "messages.schema.json#/$defs/canton.prepared" },
3419
+ { method: "POST", path: "/v1/filler/canton/submit", auth: "bearer", request: "messages.schema.json#/$defs/canton.submit", response: "messages.schema.json#/$defs/canton.submitted" },
3420
+ { method: "GET", path: "/v1/filler/canton/party", auth: "bearer", response: "#/$defs/cantonParty" },
3421
+ { method: "GET", path: "/v1/filler/canton/holdings", auth: "bearer", query: "#/$defs/pageQuery", response: "#/$defs/cantonHoldingList" },
3422
+ { method: "GET", path: "/v1/filler/canton/delivery-orders", auth: "bearer", query: "#/$defs/pageQuery", response: "#/$defs/cantonDeliveryOrderList" }
2718
3423
  ],
2719
3424
  "x-error-status": {
2720
3425
  BAD_REQUEST: 400,
@@ -2731,7 +3436,11 @@ var rest_schema_default = {
2731
3436
  NOT_ELIGIBLE: 403,
2732
3437
  RATE_LIMITED: 429,
2733
3438
  INTERNAL: 500,
2734
- ATTESTATIONS_NOT_READY: 404
3439
+ ATTESTATIONS_NOT_READY: 404,
3440
+ CANTON_NOT_READY: 409,
3441
+ CANTON_REFUSED: 422,
3442
+ CANTON_UNAVAILABLE: 503,
3443
+ OPERATION_EXPIRED: 410
2735
3444
  },
2736
3445
  $defs: {
2737
3446
  errorBody: { $ref: "messages.schema.json#/$defs/errorS2F" },
@@ -2838,6 +3547,60 @@ var rest_schema_default = {
2838
3547
  type: "object",
2839
3548
  required: ["items", "nextCursor"],
2840
3549
  properties: { items: { type: "array", items: { $ref: "#/$defs/penaltyRecord" } }, nextCursor: { type: ["string", "null"] } }
3550
+ },
3551
+ cantonParty: {
3552
+ type: "object",
3553
+ description: "The filler's Canton party and its FillerRegistryEntry with the operator. party null: none allocated or registered yet (party.allocate). registry.state NONE: no proposal yet; PROPOSED: accept it (registry.accept); ACTIVE: the Canton routes may be activated; REMOVED: staff removed the entry",
3554
+ required: ["party", "publicKey", "registry"],
3555
+ properties: {
3556
+ party: { type: ["string", "null"], minLength: 1 },
3557
+ publicKey: { anyOf: [{ $ref: "messages.schema.json#/$defs/edPublicKey" }, { type: "null" }] },
3558
+ registry: {
3559
+ type: "object",
3560
+ required: ["state", "proposalCid", "entryCid"],
3561
+ properties: {
3562
+ state: { anyOf: [{ enum: ["NONE", "PROPOSED", "ACTIVE", "REMOVED"] }, { $ref: "messages.schema.json#/$defs/futureEnumValue" }] },
3563
+ proposalCid: { type: ["string", "null"] },
3564
+ entryCid: { type: ["string", "null"] }
3565
+ }
3566
+ }
3567
+ }
3568
+ },
3569
+ cantonHolding: {
3570
+ type: "object",
3571
+ required: ["contractId", "asset", "amount", "locked"],
3572
+ properties: {
3573
+ contractId: { type: "string", minLength: 1 },
3574
+ asset: { $ref: "messages.schema.json#/$defs/cantonAsset" },
3575
+ amount: { type: "string", pattern: "^(0|[1-9][0-9]*)(\\.[0-9]{1,10})?$", description: "Daml Decimal" },
3576
+ locked: { type: "boolean", description: "held by a lock (an allocation or a pending transfer); not spendable by delivery.fill" }
3577
+ }
3578
+ },
3579
+ cantonHoldingList: {
3580
+ type: "object",
3581
+ description: "Holdings of the party (CNRX and Canton Coin among them), oldest first",
3582
+ required: ["items", "nextCursor"],
3583
+ properties: { items: { type: "array", items: { $ref: "#/$defs/cantonHolding" } }, nextCursor: { type: ["string", "null"] } }
3584
+ },
3585
+ cantonDeliveryOrder: {
3586
+ type: "object",
3587
+ required: ["deliveryOrderCid", "orderHash", "attempt", "asset", "amount", "recipient", "repayTo", "validUntil"],
3588
+ properties: {
3589
+ deliveryOrderCid: { type: "string", minLength: 1 },
3590
+ orderHash: { $ref: "messages.schema.json#/$defs/bytes32" },
3591
+ attempt: { $ref: "messages.schema.json#/$defs/uint32" },
3592
+ asset: { $ref: "messages.schema.json#/$defs/cantonAsset" },
3593
+ amount: { type: "string", pattern: "^(0|[1-9][0-9]*)(\\.[0-9]{1,10})?$", description: "Daml Decimal" },
3594
+ recipient: { type: "string", minLength: 1 },
3595
+ repayTo: { $ref: "messages.schema.json#/$defs/repayTo" },
3596
+ validUntil: { $ref: "messages.schema.json#/$defs/timeS" }
3597
+ }
3598
+ },
3599
+ cantonDeliveryOrderList: {
3600
+ type: "object",
3601
+ description: "The live DeliveryOrders naming the party as filler, oldest first",
3602
+ required: ["items", "nextCursor"],
3603
+ properties: { items: { type: "array", items: { $ref: "#/$defs/cantonDeliveryOrder" } }, nextCursor: { type: ["string", "null"] } }
2841
3604
  }
2842
3605
  }
2843
3606
  };
@@ -3005,6 +3768,6 @@ function describeRevert(selectorOrData, tables) {
3005
3768
  return void 0;
3006
3769
  }
3007
3770
 
3008
- export { ASYNCAPI, BPS, BUILD_HASHES, BYTECODE_HASHES, CANTON_ORIGIN_ID, CANTON_SOURCE_ANCHOR, CANTON_TICKET_RECEIPT_TYPES, CONTRACTS_RELEASE, DAML_NUMERIC_SCALE, DECLINE_REASONS, DEPLOYMENTS, DRAND_QUICKNET, DRAW_CLOSED_BY, EIP2294_MAX_CHAIN_ID, ERROR_CODES, ERROR_HTTP_STATUS, EXEMPT_REASONS, EXPIRED_RESULTS, FEE_CLAIM_DOMAIN_NAME, FEE_CLAIM_DOMAIN_VERSION, FEE_CLAIM_TYPES, FILLER_AUTH_TYPES, FILLER_CLOSE_CODES, FILLER_GATEWAYS, FILLER_ID_PATTERN, FILLER_KEY_REGISTRATION_TYPES, FILLER_MESSAGE_TYPES, FILLER_PROTOCOL_DOMAIN, FILLER_QUOTE_TYPES, FILLER_UPGRADE_REFUSALS, FILLER_WS_BEARER_PREFIX, FILLER_WS_SUBPROTOCOL, FILL_PROOF_DOMAIN, FILL_PROOF_TYPES, FILL_PROOF_TYPE_STRING, FILL_TICKET_DOMAIN, FILL_TICKET_TYPES, GATEWAY_MESSAGE_TYPES, GRACE, INSTRUMENT_LABEL_TAG, MAX_FEE_BPS, MAX_FILL_TTL, MAX_PROOF_WINDOW, MAX_SIG_TTL, MESSAGE_DIRECTIONS, MIN_FILL_TTL, ORDER_TYPES, OWNER_LABEL_TAG, PENALTY_STEPS, PERMIT2_ADDRESS, PERMIT2_WITNESS_TYPE_STRING, PERMIT_WITNESS_TYPES, PROOF_KIND_ATTESTATION, PROTOCOL_SCHEMAS, PROTOCOL_VERSION, QUOTE_ACK_STATUSES, QUOTE_FINAL_STATUSES, QUOTE_TYPES, REST_ENDPOINTS, REST_ONLY_TYPES, SCHEMA_VOCABULARY, SET_DELAY, STAKE_BINDING_TYPES, TICKET_INTENT_TYPES, TICKET_LIST_STATUSES, TICKET_RECEIPT_TYPES, TICKET_REFUSED_REASONS, buildCantonSourceOrder, cantonInclusiveFeeSplit, cantonNetworkOfDestination, cantonSigEntries, cantonTicketReceipt, deliveryOrderCidHash, deploymentOf, describeRevert, drawValue, drawWinner, encodeCantonAmount, encodeCantonDestination, encodeCantonOutputAsset, encodeCantonRecipient, encodeType, evmAddressFromRepayTo, feeClaimDomain, fillProofDomain, fillerEnvelopeError, fillerIdHash, fillerMessageBodyHash, fillerWsProtocols, firstRoundAtOrAfter, gatewayBodyHash, hashCantonTicketReceipt, hashDomain, hashFillProof, hashFillTicket, hashFillerKeyRegistration, hashFillerMessage, hashFillerQuote, hashOrder, hashPermitWitness, hashStruct, hashTicketIntent, hashTypedData, inclusiveFeeSplit, isCantonOriginId, isCantonSource, isEoaSignature, isEvmRepayTo, jcs, messageIdRetainUntil, messageSchemaRef, permit2Domain, repayToFromEvm, repayToFromParty, requestIdHash, routerDomain, settleAttestationsErrors, settleAttestationsPayload, settleAttestationsPayloadHash, settleSigs, sourceOrderHash, typeHash };
3771
+ export { ASYNCAPI, BPS, BUILD_HASHES, BYTECODE_HASHES, CANTON_LEG_KINDS, CANTON_OPS, CANTON_ORIGIN_ID, CANTON_REGISTRY_STATES, CANTON_SOURCE_ANCHOR, CANTON_TICKET_RECEIPT_TYPES, CANTON_TRANSFER_OUTCOMES, CONTRACTS_RELEASE, DAML_NUMERIC_SCALE, DECLINE_REASONS, DEPLOYMENTS, DRAND_QUICKNET, DRAW_CLOSED_BY, EIP2294_MAX_CHAIN_ID, ERROR_CODES, ERROR_HTTP_STATUS, EXEMPT_REASONS, EXPIRED_RESULTS, FEE_CLAIM_DOMAIN_NAME, FEE_CLAIM_DOMAIN_VERSION, FEE_CLAIM_TYPES, FILLER_AUTH_TYPES, FILLER_CLOSE_CODES, FILLER_GATEWAYS, FILLER_ID_PATTERN, FILLER_KEY_REGISTRATION_TYPES, FILLER_MESSAGE_TYPES, FILLER_PROTOCOL_DOMAIN, FILLER_QUOTE_TYPES, FILLER_UPGRADE_REFUSALS, FILLER_WS_BEARER_PREFIX, FILLER_WS_SUBPROTOCOL, FILL_PROOF_DOMAIN, FILL_PROOF_TYPES, FILL_PROOF_TYPE_STRING, FILL_TICKET_DOMAIN, FILL_TICKET_TYPES, GATEWAY_MESSAGE_TYPES, GRACE, INSTRUMENT_LABEL_TAG, MAX_FEE_BPS, MAX_FILL_TTL, MAX_PROOF_WINDOW, MAX_SIG_TTL, MESSAGE_DIRECTIONS, MIN_FILL_TTL, ORDER_TYPES, OWNER_LABEL_TAG, PENALTY_STEPS, PERMIT2_ADDRESS, PERMIT2_WITNESS_TYPE_STRING, PERMIT_WITNESS_TYPES, PROOF_KIND_ATTESTATION, PROTOCOL_SCHEMAS, PROTOCOL_VERSION, QUOTE_ACK_STATUSES, QUOTE_FINAL_STATUSES, QUOTE_TYPES, REST_ENDPOINTS, REST_ONLY_TYPES, SCHEMA_VOCABULARY, SET_DELAY, STAKE_BINDING_TYPES, TICKET_INTENT_TYPES, TICKET_LIST_STATUSES, TICKET_RECEIPT_TYPES, TICKET_REFUSED_REASONS, buildCantonSourceOrder, cantonInclusiveFeeSplit, cantonNetworkOfDestination, cantonSigEntries, cantonTicketReceipt, deliveryOrderCidHash, deploymentOf, describeRevert, drawValue, drawWinner, encodeCantonAmount, encodeCantonDestination, encodeCantonOutputAsset, encodeCantonRecipient, encodeType, evmAddressFromRepayTo, feeClaimDomain, fillProofDomain, fillerEnvelopeError, fillerIdHash, fillerMessageBodyHash, fillerWsProtocols, firstRoundAtOrAfter, gatewayBodyHash, hashCantonTicketReceipt, hashDomain, hashFillProof, hashFillTicket, hashFillerKeyRegistration, hashFillerMessage, hashFillerQuote, hashOrder, hashPermitWitness, hashStruct, hashTicketIntent, hashTypedData, inclusiveFeeSplit, isCantonOriginId, isCantonSource, isEoaSignature, isEvmRepayTo, jcs, messageIdRetainUntil, messageSchemaRef, permit2Domain, repayToFromEvm, repayToFromParty, requestIdHash, routerDomain, settleAttestationsErrors, settleAttestationsPayload, settleAttestationsPayloadHash, settleSigs, sourceOrderHash, typeHash };
3009
3772
  //# sourceMappingURL=index.js.map
3010
3773
  //# sourceMappingURL=index.js.map