@secondlayer/stacks 5.1.3 → 6.1.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.
- package/README.md +1 -8
- package/dist/shared/{stacks-qt8ehebn.js → stacks-esm-0rdxcta7.js} +2 -2
- package/dist/shared/{stacks-qt8ehebn.js.map → stacks-esm-0rdxcta7.js.map} +1 -1
- package/dist/shared/{stacks-4hs8r4q2.js → stacks-esm-1jae0a3r.js} +2 -2
- package/dist/shared/{stacks-xjkn3en1.cjs.map → stacks-esm-1jae0a3r.js.map} +1 -1
- package/dist/shared/{stacks-4d7c3x27.js → stacks-esm-2mc7ebrm.js} +3 -3
- package/dist/shared/{stacks-4d7c3x27.js.map → stacks-esm-2mc7ebrm.js.map} +1 -1
- package/dist/shared/{stacks-8brgfvqx.js → stacks-esm-3g33bqsm.js} +4 -4
- package/dist/shared/{stacks-8brgfvqx.js.map → stacks-esm-3g33bqsm.js.map} +1 -1
- package/dist/shared/{stacks-gjz26k6b.js → stacks-esm-3pv5avgr.js} +59 -15
- package/dist/shared/stacks-esm-3pv5avgr.js.map +12 -0
- package/dist/shared/{stacks-qex691bh.js → stacks-esm-743jfh10.js} +6 -6
- package/dist/shared/{stacks-qex691bh.js.map → stacks-esm-743jfh10.js.map} +1 -1
- package/dist/shared/{stacks-wxfd6r4b.js → stacks-esm-7fpqgtyx.js} +3 -3
- package/dist/shared/{stacks-wxfd6r4b.js.map → stacks-esm-7fpqgtyx.js.map} +1 -1
- package/dist/shared/{stacks-71k0vmct.js → stacks-esm-9rnx0zxr.js} +5 -5
- package/dist/shared/{stacks-71k0vmct.js.map → stacks-esm-9rnx0zxr.js.map} +1 -1
- package/dist/shared/{stacks-fd4rx56e.js → stacks-esm-aw2mj3sj.js} +7 -7
- package/dist/shared/{stacks-fd4rx56e.js.map → stacks-esm-aw2mj3sj.js.map} +1 -1
- package/dist/shared/{stacks-qs5fzts5.js → stacks-esm-cvhazvhd.js} +2 -2
- package/dist/shared/{stacks-qs5fzts5.js.map → stacks-esm-cvhazvhd.js.map} +1 -1
- package/dist/shared/{stacks-69nq48jp.js → stacks-esm-fcfdn2zx.js} +5 -5
- package/dist/shared/{stacks-69nq48jp.js.map → stacks-esm-fcfdn2zx.js.map} +1 -1
- package/dist/shared/{stacks-x0qqwrev.js → stacks-esm-hr7fpxtj.js} +4 -4
- package/dist/shared/{stacks-x0qqwrev.js.map → stacks-esm-hr7fpxtj.js.map} +1 -1
- package/dist/shared/{stacks-mbt36bzt.js → stacks-esm-kds4n82p.js} +11 -11
- package/dist/shared/{stacks-mbt36bzt.js.map → stacks-esm-kds4n82p.js.map} +1 -1
- package/dist/shared/{stacks-kg1npstf.js → stacks-esm-n53kvwmt.js} +2 -2
- package/dist/shared/{stacks-kg1npstf.js.map → stacks-esm-n53kvwmt.js.map} +1 -1
- package/dist/shared/{stacks-v2rfr46a.js → stacks-esm-pxhfqfff.js} +4 -4
- package/dist/shared/{stacks-v2rfr46a.js.map → stacks-esm-pxhfqfff.js.map} +1 -1
- package/dist/shared/{stacks-yajyej2y.js → stacks-esm-q19a17fd.js} +3 -3
- package/dist/shared/{stacks-yajyej2y.js.map → stacks-esm-q19a17fd.js.map} +1 -1
- package/dist/shared/{stacks-v03zef3g.js → stacks-esm-qk0p9fr6.js} +9 -9
- package/dist/shared/{stacks-v03zef3g.js.map → stacks-esm-qk0p9fr6.js.map} +1 -1
- package/dist/shared/{stacks-qcae5852.js → stacks-esm-qkj67g80.js} +2 -2
- package/dist/shared/{stacks-qcae5852.js.map → stacks-esm-qkj67g80.js.map} +1 -1
- package/dist/shared/{stacks-mftyrc60.js → stacks-esm-r6dejrgr.js} +4 -4
- package/dist/shared/{stacks-mftyrc60.js.map → stacks-esm-r6dejrgr.js.map} +1 -1
- package/dist/shared/{stacks-9c1yam8b.js → stacks-esm-r9q4wnyw.js} +5 -5
- package/dist/shared/{stacks-9c1yam8b.js.map → stacks-esm-r9q4wnyw.js.map} +1 -1
- package/dist/shared/{stacks-51ybf135.js → stacks-esm-skmcf5n2.js} +5 -5
- package/dist/shared/{stacks-51ybf135.js.map → stacks-esm-skmcf5n2.js.map} +1 -1
- package/dist/shared/{stacks-yvb7rvwk.js → stacks-esm-v45990hx.js} +2 -2
- package/dist/shared/{stacks-8vzxax5e.cjs.map → stacks-esm-v45990hx.js.map} +1 -1
- package/dist/shared/{stacks-z90xdr1x.js → stacks-esm-wv67m4g6.js} +3 -3
- package/dist/shared/{stacks-z90xdr1x.js.map → stacks-esm-wv67m4g6.js.map} +1 -1
- package/dist/shared/{stacks-1m3m1agc.js → stacks-esm-x1r01353.js} +5 -5
- package/dist/shared/{stacks-1m3m1agc.js.map → stacks-esm-x1r01353.js.map} +1 -1
- package/dist/src/accounts/index.cjs +558 -4
- package/dist/src/accounts/index.cjs.map +10 -4
- package/dist/src/accounts/index.js +3 -3
- package/dist/src/actions/index.cjs +3815 -1
- package/dist/src/actions/index.cjs.map +65 -3
- package/dist/src/actions/index.js +14 -14
- package/dist/src/bitcoin/index.cjs +2477 -1
- package/dist/src/bitcoin/index.cjs.map +31 -3
- package/dist/src/bitcoin/index.js +11 -11
- package/dist/src/bns/index.cjs +4439 -17
- package/dist/src/bns/index.cjs.map +50 -3
- package/dist/src/bns/index.js +14 -14
- package/dist/src/chains/index.cjs +135 -1
- package/dist/src/chains/index.cjs.map +5 -3
- package/dist/src/chains/index.js +1 -1
- package/dist/src/clarity/index.cjs +2019 -1
- package/dist/src/clarity/index.cjs.map +24 -3
- package/dist/src/clarity/index.js +8 -8
- package/dist/src/filters/index.cjs +725 -1
- package/dist/src/filters/index.cjs.map +11 -3
- package/dist/src/filters/index.d.cts +76 -13
- package/dist/src/filters/index.d.ts +76 -13
- package/dist/src/filters/index.js +8 -4
- package/dist/src/filters/index.js.map +1 -1
- package/dist/src/index.cjs +3935 -62
- package/dist/src/index.cjs.map +69 -4
- package/dist/src/index.d.cts +62 -11
- package/dist/src/index.d.ts +62 -11
- package/dist/src/index.js +16 -16
- package/dist/src/postconditions/index.cjs +1726 -1
- package/dist/src/postconditions/index.cjs.map +20 -3
- package/dist/src/postconditions/index.js +6 -6
- package/dist/src/pox/index.cjs +3855 -1
- package/dist/src/pox/index.cjs.map +48 -3
- package/dist/src/pox/index.js +13 -13
- package/dist/src/pox5/index.cjs +4054 -29
- package/dist/src/pox5/index.cjs.map +54 -3
- package/dist/src/pox5/index.js +15 -15
- package/dist/src/sbtc/index.cjs +3705 -4
- package/dist/src/sbtc/index.cjs.map +47 -3
- package/dist/src/sbtc/index.js +12 -12
- package/dist/src/stackingdao/index.cjs +3751 -8
- package/dist/src/stackingdao/index.cjs.map +45 -3
- package/dist/src/stackingdao/index.js +12 -12
- package/dist/src/subscriptions/index.cjs +153 -1
- package/dist/src/subscriptions/index.cjs.map +6 -3
- package/dist/src/subscriptions/index.js +2 -2
- package/dist/src/transactions/index.cjs +2139 -1
- package/dist/src/transactions/index.cjs.map +23 -3
- package/dist/src/transactions/index.js +6 -6
- package/dist/src/utils/index.cjs +435 -3
- package/dist/src/utils/index.cjs.map +9 -3
- package/dist/src/utils/index.js +3 -3
- package/package.json +3 -23
- package/dist/shared/stacks-02actsrx.cjs +0 -17
- package/dist/shared/stacks-02actsrx.cjs.map +0 -10
- package/dist/shared/stacks-03vfm21t.cjs +0 -222
- package/dist/shared/stacks-03vfm21t.cjs.map +0 -12
- package/dist/shared/stacks-24h5k94q.cjs +0 -74
- package/dist/shared/stacks-24h5k94q.cjs.map +0 -11
- package/dist/shared/stacks-37kz5t9f.cjs +0 -764
- package/dist/shared/stacks-37kz5t9f.cjs.map +0 -23
- package/dist/shared/stacks-3mt2q2na.cjs +0 -65
- package/dist/shared/stacks-3mt2q2na.cjs.map +0 -9
- package/dist/shared/stacks-4hs8r4q2.js.map +0 -10
- package/dist/shared/stacks-8vzxax5e.cjs +0 -45
- package/dist/shared/stacks-agk106zs.cjs +0 -267
- package/dist/shared/stacks-agk106zs.cjs.map +0 -12
- package/dist/shared/stacks-bdgh9n83.cjs +0 -212
- package/dist/shared/stacks-bdgh9n83.cjs.map +0 -11
- package/dist/shared/stacks-dpxnxhqb.cjs +0 -51
- package/dist/shared/stacks-dpxnxhqb.cjs.map +0 -11
- package/dist/shared/stacks-ee53k9j2.cjs +0 -651
- package/dist/shared/stacks-ee53k9j2.cjs.map +0 -13
- package/dist/shared/stacks-enpj9krt.cjs +0 -38
- package/dist/shared/stacks-enpj9krt.cjs.map +0 -10
- package/dist/shared/stacks-f35mnrmg.cjs +0 -164
- package/dist/shared/stacks-f35mnrmg.cjs.map +0 -10
- package/dist/shared/stacks-fhzwsn5d.cjs +0 -261
- package/dist/shared/stacks-fhzwsn5d.cjs.map +0 -12
- package/dist/shared/stacks-gjz26k6b.js.map +0 -12
- package/dist/shared/stacks-gza2n1zs.cjs +0 -73
- package/dist/shared/stacks-gza2n1zs.cjs.map +0 -11
- package/dist/shared/stacks-kem68d80.cjs +0 -156
- package/dist/shared/stacks-kem68d80.cjs.map +0 -10
- package/dist/shared/stacks-n98w7g57.cjs +0 -234
- package/dist/shared/stacks-n98w7g57.cjs.map +0 -10
- package/dist/shared/stacks-p337hp6m.cjs +0 -336
- package/dist/shared/stacks-p337hp6m.cjs.map +0 -25
- package/dist/shared/stacks-q34k4vnc.cjs +0 -286
- package/dist/shared/stacks-q34k4vnc.cjs.map +0 -12
- package/dist/shared/stacks-rryme9bv.cjs +0 -569
- package/dist/shared/stacks-rryme9bv.cjs.map +0 -13
- package/dist/shared/stacks-s5vej5z6.cjs +0 -410
- package/dist/shared/stacks-s5vej5z6.cjs.map +0 -15
- package/dist/shared/stacks-sdqkapct.cjs +0 -67
- package/dist/shared/stacks-sdqkapct.cjs.map +0 -12
- package/dist/shared/stacks-vea7nde7.cjs +0 -731
- package/dist/shared/stacks-vea7nde7.cjs.map +0 -13
- package/dist/shared/stacks-wk8yp13j.cjs +0 -33
- package/dist/shared/stacks-wk8yp13j.cjs.map +0 -11
- package/dist/shared/stacks-xjkn3en1.cjs +0 -42
- package/dist/shared/stacks-xnrywjf1.cjs +0 -131
- package/dist/shared/stacks-xnrywjf1.cjs.map +0 -11
- package/dist/shared/stacks-yvb7rvwk.js.map +0 -10
- package/dist/src/tools/btc/index.cjs +0 -131
- package/dist/src/tools/btc/index.cjs.map +0 -10
- package/dist/src/tools/btc/index.d.cts +0 -10
- package/dist/src/tools/btc/index.d.ts +0 -10
- package/dist/src/tools/btc/index.js +0 -90
- package/dist/src/tools/btc/index.js.map +0 -10
- package/dist/src/tools/index.cjs +0 -3865
- package/dist/src/tools/index.cjs.map +0 -80
- package/dist/src/tools/index.d.cts +0 -206
- package/dist/src/tools/index.d.ts +0 -206
- package/dist/src/tools/index.js +0 -3827
- package/dist/src/tools/index.js.map +0 -80
package/dist/src/index.d.cts
CHANGED
|
@@ -1,10 +1,15 @@
|
|
|
1
1
|
declare const DECODED_EVENT_TYPES: readonly ["stx_transfer", "stx_mint", "stx_burn", "stx_lock", "ft_transfer", "ft_mint", "ft_burn", "nft_transfer", "nft_mint", "nft_burn", "print"];
|
|
2
2
|
type DecodedEventType = (typeof DECODED_EVENT_TYPES)[number];
|
|
3
|
+
/** Opt-in node vm_events, stored names. Parallel to DECODED_EVENT_TYPES — not
|
|
4
|
+
* the decoded_events / Streams 1.0 vocab. Cursor second component is
|
|
5
|
+
* ordinal. Inner calls are never `contract_call`. */
|
|
6
|
+
declare const VM_EVENT_TYPES: readonly ["nested_contract_call", "var_set", "map_set", "map_insert", "map_delete"];
|
|
7
|
+
type VmEventType = (typeof VM_EVENT_TYPES)[number];
|
|
3
8
|
/** Every chain-event filter member across all four surfaces: the 10 decoded
|
|
4
9
|
* token/STX types, the three contract-shaped types (spelled as subgraphs and
|
|
5
10
|
* triggers spell them — Index/Streams project `print_event` → `print`), and
|
|
6
|
-
* the five sBTC lifecycle types (
|
|
7
|
-
declare const CHAIN_EVENT_FILTER_TYPES: readonly ["stx_transfer", "stx_mint", "stx_burn", "stx_lock", "ft_transfer", "ft_mint", "ft_burn", "nft_transfer", "nft_mint", "nft_burn", "contract_call", "contract_deploy", "print_event", "sbtc_deposit", "sbtc_withdrawal_create", "sbtc_withdrawal_accept", "sbtc_withdrawal_reject", "sbtc_withdrawal_swept_confirmed"];
|
|
11
|
+
* the five sBTC lifecycle types (Webhooks-only). */
|
|
12
|
+
declare const CHAIN_EVENT_FILTER_TYPES: readonly ["stx_transfer", "stx_mint", "stx_burn", "stx_lock", "ft_transfer", "ft_mint", "ft_burn", "nft_transfer", "nft_mint", "nft_burn", "contract_call", "contract_deploy", "print_event", "nested_contract_call", "var_set", "map_set", "map_insert", "map_delete", "sbtc_deposit", "sbtc_withdrawal_create", "sbtc_withdrawal_accept", "sbtc_withdrawal_reject", "sbtc_withdrawal_swept_confirmed"];
|
|
8
13
|
type ChainEventFilterType = (typeof CHAIN_EVENT_FILTER_TYPES)[number];
|
|
9
14
|
/** C32-encoded address version bytes for single-sig and multi-sig on each network. */
|
|
10
15
|
declare const AddressVersion: {
|
|
@@ -141,7 +146,7 @@ interface AbiContract {
|
|
|
141
146
|
* A value that is only known at runtime (config, env) is not narrow enough on
|
|
142
147
|
* purpose; run it through {@link assetId} once, which validates and narrows.
|
|
143
148
|
*
|
|
144
|
-
* Wildcard patterns (
|
|
149
|
+
* Wildcard patterns (Webhooks/Subgraphs-only) are admitted by the second arm — they
|
|
145
150
|
* are legitimately not full identifiers (`SPB.*`), and the runtime validator
|
|
146
151
|
* short-circuits on them for the same reason.
|
|
147
152
|
*/
|
|
@@ -255,6 +260,33 @@ interface ContractDeploySpec {
|
|
|
255
260
|
deployer?: string;
|
|
256
261
|
contractName?: string;
|
|
257
262
|
}
|
|
263
|
+
interface NestedContractCallSpec extends TraitScope, FactoryScope {
|
|
264
|
+
type: "nested_contract_call";
|
|
265
|
+
contractId?: string | readonly string[];
|
|
266
|
+
functionName?: string;
|
|
267
|
+
caller?: string;
|
|
268
|
+
sender?: string;
|
|
269
|
+
}
|
|
270
|
+
interface VarSetSpec extends TraitScope, FactoryScope {
|
|
271
|
+
type: "var_set";
|
|
272
|
+
contractId?: string | readonly string[];
|
|
273
|
+
varName?: string;
|
|
274
|
+
}
|
|
275
|
+
interface MapSetSpec extends TraitScope, FactoryScope {
|
|
276
|
+
type: "map_set";
|
|
277
|
+
contractId?: string | readonly string[];
|
|
278
|
+
map?: string;
|
|
279
|
+
}
|
|
280
|
+
interface MapInsertSpec extends TraitScope, FactoryScope {
|
|
281
|
+
type: "map_insert";
|
|
282
|
+
contractId?: string | readonly string[];
|
|
283
|
+
map?: string;
|
|
284
|
+
}
|
|
285
|
+
interface MapDeleteSpec extends TraitScope, FactoryScope {
|
|
286
|
+
type: "map_delete";
|
|
287
|
+
contractId?: string | readonly string[];
|
|
288
|
+
map?: string;
|
|
289
|
+
}
|
|
258
290
|
interface PrintEventSpec extends TraitScope, FactoryScope {
|
|
259
291
|
type: "print_event";
|
|
260
292
|
/** One contract id, or a set of them (max 20). */
|
|
@@ -293,7 +325,7 @@ interface SbtcWithdrawalSweptConfirmedSpec {
|
|
|
293
325
|
requestId?: number;
|
|
294
326
|
sweepTxid?: string;
|
|
295
327
|
}
|
|
296
|
-
type ChainEventFilterSpec = StxTransferSpec | StxMintSpec | StxBurnSpec | StxLockSpec | FtTransferSpec | FtMintSpec | FtBurnSpec | NftTransferSpec | NftMintSpec | NftBurnSpec | ContractCallSpec | ContractDeploySpec | PrintEventSpec | SbtcDepositSpec | SbtcWithdrawalCreateSpec | SbtcWithdrawalAcceptSpec | SbtcWithdrawalRejectSpec | SbtcWithdrawalSweptConfirmedSpec;
|
|
328
|
+
type ChainEventFilterSpec = StxTransferSpec | StxMintSpec | StxBurnSpec | StxLockSpec | FtTransferSpec | FtMintSpec | FtBurnSpec | NftTransferSpec | NftMintSpec | NftBurnSpec | ContractCallSpec | ContractDeploySpec | NestedContractCallSpec | VarSetSpec | MapSetSpec | MapInsertSpec | MapDeleteSpec | PrintEventSpec | SbtcDepositSpec | SbtcWithdrawalCreateSpec | SbtcWithdrawalAcceptSpec | SbtcWithdrawalRejectSpec | SbtcWithdrawalSweptConfirmedSpec;
|
|
297
329
|
type SpecFor<T extends ChainEventFilterType> = Extract<ChainEventFilterSpec, {
|
|
298
330
|
type: T
|
|
299
331
|
}>;
|
|
@@ -304,12 +336,16 @@ type SpecFor<T extends ChainEventFilterType> = Extract<ChainEventFilterSpec, {
|
|
|
304
336
|
type ChainTriggerOf<S> = { [K in keyof Omit<S, "abi" | "prints" | "factory">] : Exclude<S[K], bigint | readonly string[]> | (bigint extends S[K] ? string : never) };
|
|
305
337
|
/** Params fragment for `index.events.*` (spread into list/walk/consume). */
|
|
306
338
|
type IndexEventsParamsShape = {
|
|
307
|
-
eventType: DecodedEventType
|
|
339
|
+
eventType: DecodedEventType | VmEventType
|
|
308
340
|
/** A spec's contract set passes through verbatim (the API takes up to 20). */
|
|
309
341
|
contractId?: string | readonly string[]
|
|
310
342
|
assetIdentifier?: AssetIdentifier
|
|
311
343
|
sender?: string
|
|
312
344
|
recipient?: string
|
|
345
|
+
functionName?: string
|
|
346
|
+
caller?: string
|
|
347
|
+
map?: string
|
|
348
|
+
varName?: string
|
|
313
349
|
trait?: string
|
|
314
350
|
};
|
|
315
351
|
/** Params fragment for `index.contractCalls.*`. */
|
|
@@ -322,7 +358,11 @@ type ContractCallsParamsShape = {
|
|
|
322
358
|
sender?: string
|
|
323
359
|
trait?: string
|
|
324
360
|
};
|
|
325
|
-
|
|
361
|
+
type VmMember = "nested_contract_call" | "var_set" | "map_set" | "map_insert" | "map_delete";
|
|
362
|
+
/** Params fragment for classic `streams.events.*` (Streams 1.0). VM members
|
|
363
|
+
* project to {@link StreamsVmParamsShape} instead — mixing the vocabularies
|
|
364
|
+
* here makes `events.consume({ ...on.ftTransfer().toStreamsParams(), onBatch })`
|
|
365
|
+
* fail type-check. */
|
|
326
366
|
type StreamsParamsShape = {
|
|
327
367
|
types: readonly DecodedEventType[]
|
|
328
368
|
contractId?: string | readonly string[]
|
|
@@ -330,22 +370,28 @@ type StreamsParamsShape = {
|
|
|
330
370
|
recipient?: string
|
|
331
371
|
assetIdentifier?: AssetIdentifier
|
|
332
372
|
};
|
|
373
|
+
/** VM member projection: `clock` is the `"vm"` literal so SDK overload 1 matches. */
|
|
374
|
+
type StreamsVmParamsShape<T extends VmMember = VmMember> = {
|
|
375
|
+
types: readonly [T]
|
|
376
|
+
clock: "vm"
|
|
377
|
+
contractId?: string | readonly string[]
|
|
378
|
+
};
|
|
333
379
|
type DecodedMember = "stx_transfer" | "stx_mint" | "stx_burn" | "stx_lock" | "ft_transfer" | "ft_mint" | "ft_burn" | "nft_transfer" | "nft_mint" | "nft_burn" | "print_event";
|
|
334
380
|
type ProjectionsFor<
|
|
335
381
|
T extends ChainEventFilterType,
|
|
336
382
|
S
|
|
337
383
|
> = {
|
|
338
|
-
/** Wire trigger for `
|
|
384
|
+
/** Wire trigger for `webhooks.create({ triggers: [...] })`. BigInt
|
|
339
385
|
* amounts become strings here — the one sanctioned boundary. */
|
|
340
386
|
toChainTrigger(): ChainTriggerOf<S>
|
|
341
|
-
} & (T extends DecodedMember ? {
|
|
387
|
+
} & (T extends DecodedMember | VmMember ? {
|
|
342
388
|
/** Params for `index.events.list/walk/consume` (merge your own
|
|
343
389
|
* `limit`/`fromHeight`/`txContext` etc. on top). */
|
|
344
390
|
toIndexParams<Extra extends Record<string, unknown>>(extra?: Extra): IndexEventsParamsShape & Extra
|
|
345
391
|
/** Params for `streams.events.list/consume/stream`. Throws if the
|
|
346
392
|
* filter uses `trait` (Streams has no trait resolution) or a
|
|
347
393
|
* min/max amount (Streams filters have no amount predicates). */
|
|
348
|
-
toStreamsParams<Extra extends Record<string, unknown>>(extra?: Extra): StreamsParamsShape & Extra
|
|
394
|
+
toStreamsParams<Extra extends Record<string, unknown> = Record<string, never>>(extra?: Extra): T extends VmMember ? StreamsVmParamsShape<T> & Extra : StreamsParamsShape & Extra
|
|
349
395
|
} : {}) & (T extends "contract_call" ? {
|
|
350
396
|
/** Params for `index.contractCalls.list/walk/consume`. */
|
|
351
397
|
toContractCallsParams<Extra extends Record<string, unknown>>(extra?: Extra): ContractCallsParamsShape & Extra
|
|
@@ -391,7 +437,7 @@ interface OnNamespace {
|
|
|
391
437
|
abi?: A
|
|
392
438
|
}>;
|
|
393
439
|
contractDeploy(fields?: Fields<"contract_deploy">): ChainEventFilter<"contract_deploy">;
|
|
394
|
-
/** Canonical member is `print_event` (as Subgraphs and
|
|
440
|
+
/** Canonical member is `print_event` (as Subgraphs and Webhooks spell
|
|
395
441
|
* it); `toIndexParams`/`toStreamsParams` project to `print`. `prints`
|
|
396
442
|
* literals are preserved (`const P`) for per-topic `event.data` narrowing. */
|
|
397
443
|
print<const P extends Record<string, Record<string, PrintFieldType>> | undefined = undefined>(fields?: Omit<SpecFor<"print_event">, "type" | "prints"> & {
|
|
@@ -401,6 +447,11 @@ interface OnNamespace {
|
|
|
401
447
|
} & Omit<SpecFor<"print_event">, "type" | "prints"> & {
|
|
402
448
|
prints?: P
|
|
403
449
|
}>;
|
|
450
|
+
nestedCall(fields?: Fields<"nested_contract_call">): ChainEventFilter<"nested_contract_call">;
|
|
451
|
+
varSet(fields?: Fields<"var_set">): ChainEventFilter<"var_set">;
|
|
452
|
+
mapSet(fields?: Fields<"map_set">): ChainEventFilter<"map_set">;
|
|
453
|
+
mapInsert(fields?: Fields<"map_insert">): ChainEventFilter<"map_insert">;
|
|
454
|
+
mapDelete(fields?: Fields<"map_delete">): ChainEventFilter<"map_delete">;
|
|
404
455
|
sbtcDeposit(fields?: Fields<"sbtc_deposit">): ChainEventFilter<"sbtc_deposit">;
|
|
405
456
|
sbtcWithdrawalCreate(fields?: Fields<"sbtc_withdrawal_create">): ChainEventFilter<"sbtc_withdrawal_create">;
|
|
406
457
|
sbtcWithdrawalAccept(fields?: Fields<"sbtc_withdrawal_accept">): ChainEventFilter<"sbtc_withdrawal_accept">;
|
|
@@ -417,7 +468,7 @@ interface OnNamespace {
|
|
|
417
468
|
*
|
|
418
469
|
* sl.index.events.list(usdc.toIndexParams({ limit: 100 })); // pull
|
|
419
470
|
* sl.streams.events.consume({ ...usdc.toStreamsParams(), onBatch });
|
|
420
|
-
* sl.
|
|
471
|
+
* sl.webhooks.create({ name, url, triggers: [usdc.toChainTrigger()] });
|
|
421
472
|
* defineSubgraph({ sources: { usdc: usdc.toSubgraphSource() }, schema, handlers });
|
|
422
473
|
* ```
|
|
423
474
|
*
|
package/dist/src/index.d.ts
CHANGED
|
@@ -1,10 +1,15 @@
|
|
|
1
1
|
declare const DECODED_EVENT_TYPES: readonly ["stx_transfer", "stx_mint", "stx_burn", "stx_lock", "ft_transfer", "ft_mint", "ft_burn", "nft_transfer", "nft_mint", "nft_burn", "print"];
|
|
2
2
|
type DecodedEventType = (typeof DECODED_EVENT_TYPES)[number];
|
|
3
|
+
/** Opt-in node vm_events, stored names. Parallel to DECODED_EVENT_TYPES — not
|
|
4
|
+
* the decoded_events / Streams 1.0 vocab. Cursor second component is
|
|
5
|
+
* ordinal. Inner calls are never `contract_call`. */
|
|
6
|
+
declare const VM_EVENT_TYPES: readonly ["nested_contract_call", "var_set", "map_set", "map_insert", "map_delete"];
|
|
7
|
+
type VmEventType = (typeof VM_EVENT_TYPES)[number];
|
|
3
8
|
/** Every chain-event filter member across all four surfaces: the 10 decoded
|
|
4
9
|
* token/STX types, the three contract-shaped types (spelled as subgraphs and
|
|
5
10
|
* triggers spell them — Index/Streams project `print_event` → `print`), and
|
|
6
|
-
* the five sBTC lifecycle types (
|
|
7
|
-
declare const CHAIN_EVENT_FILTER_TYPES: readonly ["stx_transfer", "stx_mint", "stx_burn", "stx_lock", "ft_transfer", "ft_mint", "ft_burn", "nft_transfer", "nft_mint", "nft_burn", "contract_call", "contract_deploy", "print_event", "sbtc_deposit", "sbtc_withdrawal_create", "sbtc_withdrawal_accept", "sbtc_withdrawal_reject", "sbtc_withdrawal_swept_confirmed"];
|
|
11
|
+
* the five sBTC lifecycle types (Webhooks-only). */
|
|
12
|
+
declare const CHAIN_EVENT_FILTER_TYPES: readonly ["stx_transfer", "stx_mint", "stx_burn", "stx_lock", "ft_transfer", "ft_mint", "ft_burn", "nft_transfer", "nft_mint", "nft_burn", "contract_call", "contract_deploy", "print_event", "nested_contract_call", "var_set", "map_set", "map_insert", "map_delete", "sbtc_deposit", "sbtc_withdrawal_create", "sbtc_withdrawal_accept", "sbtc_withdrawal_reject", "sbtc_withdrawal_swept_confirmed"];
|
|
8
13
|
type ChainEventFilterType = (typeof CHAIN_EVENT_FILTER_TYPES)[number];
|
|
9
14
|
/** C32-encoded address version bytes for single-sig and multi-sig on each network. */
|
|
10
15
|
declare const AddressVersion: {
|
|
@@ -141,7 +146,7 @@ interface AbiContract {
|
|
|
141
146
|
* A value that is only known at runtime (config, env) is not narrow enough on
|
|
142
147
|
* purpose; run it through {@link assetId} once, which validates and narrows.
|
|
143
148
|
*
|
|
144
|
-
* Wildcard patterns (
|
|
149
|
+
* Wildcard patterns (Webhooks/Subgraphs-only) are admitted by the second arm — they
|
|
145
150
|
* are legitimately not full identifiers (`SPB.*`), and the runtime validator
|
|
146
151
|
* short-circuits on them for the same reason.
|
|
147
152
|
*/
|
|
@@ -255,6 +260,33 @@ interface ContractDeploySpec {
|
|
|
255
260
|
deployer?: string;
|
|
256
261
|
contractName?: string;
|
|
257
262
|
}
|
|
263
|
+
interface NestedContractCallSpec extends TraitScope, FactoryScope {
|
|
264
|
+
type: "nested_contract_call";
|
|
265
|
+
contractId?: string | readonly string[];
|
|
266
|
+
functionName?: string;
|
|
267
|
+
caller?: string;
|
|
268
|
+
sender?: string;
|
|
269
|
+
}
|
|
270
|
+
interface VarSetSpec extends TraitScope, FactoryScope {
|
|
271
|
+
type: "var_set";
|
|
272
|
+
contractId?: string | readonly string[];
|
|
273
|
+
varName?: string;
|
|
274
|
+
}
|
|
275
|
+
interface MapSetSpec extends TraitScope, FactoryScope {
|
|
276
|
+
type: "map_set";
|
|
277
|
+
contractId?: string | readonly string[];
|
|
278
|
+
map?: string;
|
|
279
|
+
}
|
|
280
|
+
interface MapInsertSpec extends TraitScope, FactoryScope {
|
|
281
|
+
type: "map_insert";
|
|
282
|
+
contractId?: string | readonly string[];
|
|
283
|
+
map?: string;
|
|
284
|
+
}
|
|
285
|
+
interface MapDeleteSpec extends TraitScope, FactoryScope {
|
|
286
|
+
type: "map_delete";
|
|
287
|
+
contractId?: string | readonly string[];
|
|
288
|
+
map?: string;
|
|
289
|
+
}
|
|
258
290
|
interface PrintEventSpec extends TraitScope, FactoryScope {
|
|
259
291
|
type: "print_event";
|
|
260
292
|
/** One contract id, or a set of them (max 20). */
|
|
@@ -293,7 +325,7 @@ interface SbtcWithdrawalSweptConfirmedSpec {
|
|
|
293
325
|
requestId?: number;
|
|
294
326
|
sweepTxid?: string;
|
|
295
327
|
}
|
|
296
|
-
type ChainEventFilterSpec = StxTransferSpec | StxMintSpec | StxBurnSpec | StxLockSpec | FtTransferSpec | FtMintSpec | FtBurnSpec | NftTransferSpec | NftMintSpec | NftBurnSpec | ContractCallSpec | ContractDeploySpec | PrintEventSpec | SbtcDepositSpec | SbtcWithdrawalCreateSpec | SbtcWithdrawalAcceptSpec | SbtcWithdrawalRejectSpec | SbtcWithdrawalSweptConfirmedSpec;
|
|
328
|
+
type ChainEventFilterSpec = StxTransferSpec | StxMintSpec | StxBurnSpec | StxLockSpec | FtTransferSpec | FtMintSpec | FtBurnSpec | NftTransferSpec | NftMintSpec | NftBurnSpec | ContractCallSpec | ContractDeploySpec | NestedContractCallSpec | VarSetSpec | MapSetSpec | MapInsertSpec | MapDeleteSpec | PrintEventSpec | SbtcDepositSpec | SbtcWithdrawalCreateSpec | SbtcWithdrawalAcceptSpec | SbtcWithdrawalRejectSpec | SbtcWithdrawalSweptConfirmedSpec;
|
|
297
329
|
type SpecFor<T extends ChainEventFilterType> = Extract<ChainEventFilterSpec, {
|
|
298
330
|
type: T
|
|
299
331
|
}>;
|
|
@@ -304,12 +336,16 @@ type SpecFor<T extends ChainEventFilterType> = Extract<ChainEventFilterSpec, {
|
|
|
304
336
|
type ChainTriggerOf<S> = { [K in keyof Omit<S, "abi" | "prints" | "factory">] : Exclude<S[K], bigint | readonly string[]> | (bigint extends S[K] ? string : never) };
|
|
305
337
|
/** Params fragment for `index.events.*` (spread into list/walk/consume). */
|
|
306
338
|
type IndexEventsParamsShape = {
|
|
307
|
-
eventType: DecodedEventType
|
|
339
|
+
eventType: DecodedEventType | VmEventType
|
|
308
340
|
/** A spec's contract set passes through verbatim (the API takes up to 20). */
|
|
309
341
|
contractId?: string | readonly string[]
|
|
310
342
|
assetIdentifier?: AssetIdentifier
|
|
311
343
|
sender?: string
|
|
312
344
|
recipient?: string
|
|
345
|
+
functionName?: string
|
|
346
|
+
caller?: string
|
|
347
|
+
map?: string
|
|
348
|
+
varName?: string
|
|
313
349
|
trait?: string
|
|
314
350
|
};
|
|
315
351
|
/** Params fragment for `index.contractCalls.*`. */
|
|
@@ -322,7 +358,11 @@ type ContractCallsParamsShape = {
|
|
|
322
358
|
sender?: string
|
|
323
359
|
trait?: string
|
|
324
360
|
};
|
|
325
|
-
|
|
361
|
+
type VmMember = "nested_contract_call" | "var_set" | "map_set" | "map_insert" | "map_delete";
|
|
362
|
+
/** Params fragment for classic `streams.events.*` (Streams 1.0). VM members
|
|
363
|
+
* project to {@link StreamsVmParamsShape} instead — mixing the vocabularies
|
|
364
|
+
* here makes `events.consume({ ...on.ftTransfer().toStreamsParams(), onBatch })`
|
|
365
|
+
* fail type-check. */
|
|
326
366
|
type StreamsParamsShape = {
|
|
327
367
|
types: readonly DecodedEventType[]
|
|
328
368
|
contractId?: string | readonly string[]
|
|
@@ -330,22 +370,28 @@ type StreamsParamsShape = {
|
|
|
330
370
|
recipient?: string
|
|
331
371
|
assetIdentifier?: AssetIdentifier
|
|
332
372
|
};
|
|
373
|
+
/** VM member projection: `clock` is the `"vm"` literal so SDK overload 1 matches. */
|
|
374
|
+
type StreamsVmParamsShape<T extends VmMember = VmMember> = {
|
|
375
|
+
types: readonly [T]
|
|
376
|
+
clock: "vm"
|
|
377
|
+
contractId?: string | readonly string[]
|
|
378
|
+
};
|
|
333
379
|
type DecodedMember = "stx_transfer" | "stx_mint" | "stx_burn" | "stx_lock" | "ft_transfer" | "ft_mint" | "ft_burn" | "nft_transfer" | "nft_mint" | "nft_burn" | "print_event";
|
|
334
380
|
type ProjectionsFor<
|
|
335
381
|
T extends ChainEventFilterType,
|
|
336
382
|
S
|
|
337
383
|
> = {
|
|
338
|
-
/** Wire trigger for `
|
|
384
|
+
/** Wire trigger for `webhooks.create({ triggers: [...] })`. BigInt
|
|
339
385
|
* amounts become strings here — the one sanctioned boundary. */
|
|
340
386
|
toChainTrigger(): ChainTriggerOf<S>
|
|
341
|
-
} & (T extends DecodedMember ? {
|
|
387
|
+
} & (T extends DecodedMember | VmMember ? {
|
|
342
388
|
/** Params for `index.events.list/walk/consume` (merge your own
|
|
343
389
|
* `limit`/`fromHeight`/`txContext` etc. on top). */
|
|
344
390
|
toIndexParams<Extra extends Record<string, unknown>>(extra?: Extra): IndexEventsParamsShape & Extra
|
|
345
391
|
/** Params for `streams.events.list/consume/stream`. Throws if the
|
|
346
392
|
* filter uses `trait` (Streams has no trait resolution) or a
|
|
347
393
|
* min/max amount (Streams filters have no amount predicates). */
|
|
348
|
-
toStreamsParams<Extra extends Record<string, unknown>>(extra?: Extra): StreamsParamsShape & Extra
|
|
394
|
+
toStreamsParams<Extra extends Record<string, unknown> = Record<string, never>>(extra?: Extra): T extends VmMember ? StreamsVmParamsShape<T> & Extra : StreamsParamsShape & Extra
|
|
349
395
|
} : {}) & (T extends "contract_call" ? {
|
|
350
396
|
/** Params for `index.contractCalls.list/walk/consume`. */
|
|
351
397
|
toContractCallsParams<Extra extends Record<string, unknown>>(extra?: Extra): ContractCallsParamsShape & Extra
|
|
@@ -391,7 +437,7 @@ interface OnNamespace {
|
|
|
391
437
|
abi?: A
|
|
392
438
|
}>;
|
|
393
439
|
contractDeploy(fields?: Fields<"contract_deploy">): ChainEventFilter<"contract_deploy">;
|
|
394
|
-
/** Canonical member is `print_event` (as Subgraphs and
|
|
440
|
+
/** Canonical member is `print_event` (as Subgraphs and Webhooks spell
|
|
395
441
|
* it); `toIndexParams`/`toStreamsParams` project to `print`. `prints`
|
|
396
442
|
* literals are preserved (`const P`) for per-topic `event.data` narrowing. */
|
|
397
443
|
print<const P extends Record<string, Record<string, PrintFieldType>> | undefined = undefined>(fields?: Omit<SpecFor<"print_event">, "type" | "prints"> & {
|
|
@@ -401,6 +447,11 @@ interface OnNamespace {
|
|
|
401
447
|
} & Omit<SpecFor<"print_event">, "type" | "prints"> & {
|
|
402
448
|
prints?: P
|
|
403
449
|
}>;
|
|
450
|
+
nestedCall(fields?: Fields<"nested_contract_call">): ChainEventFilter<"nested_contract_call">;
|
|
451
|
+
varSet(fields?: Fields<"var_set">): ChainEventFilter<"var_set">;
|
|
452
|
+
mapSet(fields?: Fields<"map_set">): ChainEventFilter<"map_set">;
|
|
453
|
+
mapInsert(fields?: Fields<"map_insert">): ChainEventFilter<"map_insert">;
|
|
454
|
+
mapDelete(fields?: Fields<"map_delete">): ChainEventFilter<"map_delete">;
|
|
404
455
|
sbtcDeposit(fields?: Fields<"sbtc_deposit">): ChainEventFilter<"sbtc_deposit">;
|
|
405
456
|
sbtcWithdrawalCreate(fields?: Fields<"sbtc_withdrawal_create">): ChainEventFilter<"sbtc_withdrawal_create">;
|
|
406
457
|
sbtcWithdrawalAccept(fields?: Fields<"sbtc_withdrawal_accept">): ChainEventFilter<"sbtc_withdrawal_accept">;
|
|
@@ -417,7 +468,7 @@ interface OnNamespace {
|
|
|
417
468
|
*
|
|
418
469
|
* sl.index.events.list(usdc.toIndexParams({ limit: 100 })); // pull
|
|
419
470
|
* sl.streams.events.consume({ ...usdc.toStreamsParams(), onBatch });
|
|
420
|
-
* sl.
|
|
471
|
+
* sl.webhooks.create({ name, url, triggers: [usdc.toChainTrigger()] });
|
|
421
472
|
* defineSubgraph({ sources: { usdc: usdc.toSubgraphSource() }, schema, handlers });
|
|
422
473
|
* ```
|
|
423
474
|
*
|
package/dist/src/index.js
CHANGED
|
@@ -1,16 +1,16 @@
|
|
|
1
1
|
import {
|
|
2
2
|
on
|
|
3
|
-
} from "../shared/stacks-
|
|
3
|
+
} from "../shared/stacks-esm-3pv5avgr.js";
|
|
4
4
|
import {
|
|
5
5
|
providerToAccount
|
|
6
|
-
} from "../shared/stacks-
|
|
6
|
+
} from "../shared/stacks-esm-qkj67g80.js";
|
|
7
7
|
import {
|
|
8
8
|
defineChain,
|
|
9
9
|
devnet,
|
|
10
10
|
mainnet,
|
|
11
11
|
mocknet,
|
|
12
12
|
testnet
|
|
13
|
-
} from "../shared/stacks-
|
|
13
|
+
} from "../shared/stacks-esm-0rdxcta7.js";
|
|
14
14
|
import {
|
|
15
15
|
SimulationError,
|
|
16
16
|
deployContract,
|
|
@@ -28,12 +28,12 @@ import {
|
|
|
28
28
|
simulateTransaction,
|
|
29
29
|
sponsorTransaction,
|
|
30
30
|
transferStx
|
|
31
|
-
} from "../shared/stacks-
|
|
31
|
+
} from "../shared/stacks-esm-kds4n82p.js";
|
|
32
32
|
import {
|
|
33
33
|
getBalance,
|
|
34
34
|
getDataVar,
|
|
35
35
|
multicall
|
|
36
|
-
} from "../shared/stacks-
|
|
36
|
+
} from "../shared/stacks-esm-x1r01353.js";
|
|
37
37
|
import {
|
|
38
38
|
HttpRequestError,
|
|
39
39
|
IndexSourceConfigError,
|
|
@@ -61,12 +61,12 @@ import {
|
|
|
61
61
|
setUnsignedFee,
|
|
62
62
|
startNonceReconciler,
|
|
63
63
|
waitForTransactionReceipt
|
|
64
|
-
} from "../shared/stacks-
|
|
64
|
+
} from "../shared/stacks-esm-qk0p9fr6.js";
|
|
65
65
|
import {
|
|
66
66
|
MalformedResponseError,
|
|
67
67
|
ReadContractError,
|
|
68
68
|
readContract
|
|
69
|
-
} from "../shared/stacks-
|
|
69
|
+
} from "../shared/stacks-esm-743jfh10.js";
|
|
70
70
|
import {
|
|
71
71
|
WebSocketError,
|
|
72
72
|
watchAddress,
|
|
@@ -75,16 +75,16 @@ import {
|
|
|
75
75
|
watchMempool,
|
|
76
76
|
watchNftEvent,
|
|
77
77
|
watchTransaction
|
|
78
|
-
} from "../shared/stacks-
|
|
79
|
-
import"../shared/stacks-
|
|
78
|
+
} from "../shared/stacks-esm-7fpqgtyx.js";
|
|
79
|
+
import"../shared/stacks-esm-pxhfqfff.js";
|
|
80
80
|
import {
|
|
81
81
|
buildContractCall,
|
|
82
82
|
buildContractDeploy,
|
|
83
83
|
buildTokenTransfer,
|
|
84
84
|
finalizeMultiSig,
|
|
85
85
|
makeMultiSigAddress
|
|
86
|
-
} from "../shared/stacks-
|
|
87
|
-
import"../shared/stacks-
|
|
86
|
+
} from "../shared/stacks-esm-r9q4wnyw.js";
|
|
87
|
+
import"../shared/stacks-esm-skmcf5n2.js";
|
|
88
88
|
import {
|
|
89
89
|
BroadcastError,
|
|
90
90
|
SerializationError,
|
|
@@ -93,14 +93,14 @@ import {
|
|
|
93
93
|
TransactionDroppedError,
|
|
94
94
|
TransactionError,
|
|
95
95
|
WaitForTransactionTimeoutError
|
|
96
|
-
} from "../shared/stacks-
|
|
96
|
+
} from "../shared/stacks-esm-fcfdn2zx.js";
|
|
97
97
|
import {
|
|
98
98
|
BaseError
|
|
99
|
-
} from "../shared/stacks-
|
|
99
|
+
} from "../shared/stacks-esm-1jae0a3r.js";
|
|
100
100
|
import {
|
|
101
101
|
formatStx,
|
|
102
102
|
parseStx
|
|
103
|
-
} from "../shared/stacks-
|
|
103
|
+
} from "../shared/stacks-esm-v45990hx.js";
|
|
104
104
|
import {
|
|
105
105
|
AddressVersion,
|
|
106
106
|
MICROSTX_PER_STX,
|
|
@@ -110,8 +110,8 @@ import {
|
|
|
110
110
|
isAddressEqual,
|
|
111
111
|
isValidAddress,
|
|
112
112
|
parseContractId
|
|
113
|
-
} from "../shared/stacks-
|
|
114
|
-
import"../shared/stacks-
|
|
113
|
+
} from "../shared/stacks-esm-2mc7ebrm.js";
|
|
114
|
+
import"../shared/stacks-esm-cvhazvhd.js";
|
|
115
115
|
|
|
116
116
|
// src/clients/createClient.ts
|
|
117
117
|
var BASE_KEYS = new Set([
|