@recoillink/starknet-sdk 0.0.0-stage → 30.0.4

package/dist/ism/message-id-multisig-ism-artifact-manager.js

@@ -0,0 +1,51 @@
+import { AltVM } from '@recoillink/provider-sdk';
+import { ArtifactState, } from '@recoillink/provider-sdk/artifact';
+import { assert } from '@recoillink/utils';
+import { getMessageIdMultisigIsmConfig } from './ism-query.js';
+import { getCreateMessageIdMultisigIsmTx } from './ism-tx.js';
+export class StarknetMessageIdMultisigIsmReader {
+    provider;
+    constructor(provider) {
+        this.provider = provider;
+    }
+    async read(address) {
+        const ism = await getMessageIdMultisigIsmConfig(this.provider.getRawProvider(), address);
+        return {
+            artifactState: ArtifactState.DEPLOYED,
+            config: {
+                type: AltVM.IsmType.MESSAGE_ID_MULTISIG,
+                validators: ism.validators,
+                threshold: ism.threshold,
+            },
+            deployed: { address: ism.address },
+        };
+    }
+}
+export class StarknetMessageIdMultisigIsmWriter extends StarknetMessageIdMultisigIsmReader {
+    signer;
+    constructor(provider, signer) {
+        super(provider);
+        this.signer = signer;
+    }
+    async create(artifact) {
+        const tx = getCreateMessageIdMultisigIsmTx(this.signer.getSignerAddress(), {
+            validators: artifact.config.validators,
+            threshold: artifact.config.threshold,
+        });
+        const receipt = await this.signer.sendAndConfirmTransaction(tx);
+        const ismAddress = receipt.contractAddress;
+        assert(ismAddress, 'failed to deploy Starknet message ID multisig ISM');
+        return [
+            {
+                artifactState: ArtifactState.DEPLOYED,
+                config: artifact.config,
+                deployed: { address: ismAddress },
+            },
+            [receipt],
+        ];
+    }
+    async update(_artifact) {
+        return [];
+    }
+}
+//# sourceMappingURL=message-id-multisig-ism-artifact-manager.js.map

package/dist/ism/message-id-multisig-ism-artifact-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-id-multisig-ism-artifact-manager.js","sourceRoot":"","sources":["../../src/ism/message-id-multisig-ism-artifact-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AACjD,OAAO,EAIL,aAAa,GAEd,MAAM,mCAAmC,CAAC;AAS3C,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAI3C,OAAO,EAAE,6BAA6B,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,EAAE,+BAA+B,EAAE,MAAM,aAAa,CAAC;AAE9D,MAAM,OAAO,kCAAkC;IAId,QAAQ;IAAvC,YAA+B,QAA0B;wBAA1B,QAAQ;IAAqB,CAAC;IAE7D,KAAK,CAAC,IAAI,CACR,OAAe;QAOf,MAAM,GAAG,GAAG,MAAM,6BAA6B,CAC7C,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE,EAC9B,OAAO,CACR,CAAC;QACF,OAAO;YACL,aAAa,EAAE,aAAa,CAAC,QAAQ;YACrC,MAAM,EAAE;gBACN,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,mBAAmB;gBACvC,UAAU,EAAE,GAAG,CAAC,UAAU;gBAC1B,SAAS,EAAE,GAAG,CAAC,SAAS;aACzB;YACD,QAAQ,EAAE,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE;SACnC,CAAC;IACJ,CAAC;CACF;AAED,MAAM,OAAO,kCACX,SAAQ,kCAAkC;IASvB,MAAM;IAFzB,YACE,QAA0B,EACT,MAAsB;QAEvC,KAAK,CAAC,QAAQ,CAAC,CAAC;sBAFC,MAAM;IAGzB,CAAC;IAED,KAAK,CAAC,MAAM,CACV,QAAoE;QAUpE,MAAM,EAAE,GAAG,+BAA+B,CAAC,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE,EAAE;YACzE,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,UAAU;YACtC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,SAAS;SACrC,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,yBAAyB,CAAC,EAAE,CAAC,CAAC;QAChE,MAAM,UAAU,GAAG,OAAO,CAAC,eAAe,CAAC;QAC3C,MAAM,CAAC,UAAU,EAAE,mDAAmD,CAAC,CAAC;QACxE,OAAO;YACL;gBACE,aAAa,EAAE,aAAa,CAAC,QAAQ;gBACrC,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,QAAQ,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE;aAClC;YACD,CAAC,OAAO,CAAC;SACV,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,MAAM,CACV,SAGC;QAED,OAAO,EAAE,CAAC;IACZ,CAAC;CACF"}

package/dist/ism/test-ism-artifact-manager.d.ts

@@ -0,0 +1,20 @@
+import { type ArtifactDeployed, type ArtifactNew, type ArtifactReader, type ArtifactWriter } from '@recoillink/provider-sdk/artifact';
+import { type DeployedIsmAddress, type RawIsmArtifactConfigs } from '@recoillink/provider-sdk/ism';
+import { type AnnotatedTx, type TxReceipt } from '@recoillink/provider-sdk/module';
+import { StarknetProvider } from '../clients/provider.js';
+import { StarknetSigner } from '../clients/signer.js';
+export declare class StarknetTestIsmReader implements ArtifactReader<RawIsmArtifactConfigs['testIsm'], DeployedIsmAddress> {
+    protected readonly provider: StarknetProvider;
+    constructor(provider: StarknetProvider);
+    read(address: string): Promise<ArtifactDeployed<RawIsmArtifactConfigs['testIsm'], DeployedIsmAddress>>;
+}
+export declare class StarknetTestIsmWriter extends StarknetTestIsmReader implements ArtifactWriter<RawIsmArtifactConfigs['testIsm'], DeployedIsmAddress> {
+    private readonly signer;
+    constructor(provider: StarknetProvider, signer: StarknetSigner);
+    create(artifact: ArtifactNew<RawIsmArtifactConfigs['testIsm']>): Promise<[
+        ArtifactDeployed<RawIsmArtifactConfigs['testIsm'], DeployedIsmAddress>,
+        TxReceipt[]
+    ]>;
+    update(_artifact: ArtifactDeployed<RawIsmArtifactConfigs['testIsm'], DeployedIsmAddress>): Promise<AnnotatedTx[]>;
+}
+//# sourceMappingURL=test-ism-artifact-manager.d.ts.map

package/dist/ism/test-ism-artifact-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-ism-artifact-manager.d.ts","sourceRoot":"","sources":["../../src/ism/test-ism-artifact-manager.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,cAAc,EAEnB,KAAK,cAAc,EACpB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC3B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,SAAS,EACf,MAAM,iCAAiC,CAAC;AAGzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAItD,qBAAa,qBAAsB,YAAW,cAAc,CAC1D,qBAAqB,CAAC,SAAS,CAAC,EAChC,kBAAkB,CACnB;IACa,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB;IAAzD,YAA+B,QAAQ,EAAE,gBAAgB,EAAI;IAEvD,IAAI,CACR,OAAO,EAAE,MAAM,GACd,OAAO,CACR,gBAAgB,CAAC,qBAAqB,CAAC,SAAS,CAAC,EAAE,kBAAkB,CAAC,CACvE,CAYA;CACF;AAED,qBAAa,qBACX,SAAQ,qBACR,YACE,cAAc,CAAC,qBAAqB,CAAC,SAAS,CAAC,EAAE,kBAAkB,CAAC;IAIpE,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFzB,YACE,QAAQ,EAAE,gBAAgB,EACT,MAAM,EAAE,cAAc,EAGxC;IAEK,MAAM,CACV,QAAQ,EAAE,WAAW,CAAC,qBAAqB,CAAC,SAAS,CAAC,CAAC,GACtD,OAAO,CACR;QACE,gBAAgB,CAAC,qBAAqB,CAAC,SAAS,CAAC,EAAE,kBAAkB,CAAC;QACtE,SAAS,EAAE;KACZ,CACF,CAaA;IAEK,MAAM,CACV,SAAS,EAAE,gBAAgB,CACzB,qBAAqB,CAAC,SAAS,CAAC,EAChC,kBAAkB,CACnB,GACA,OAAO,CAAC,WAAW,EAAE,CAAC,CAExB;CACF"}

package/dist/ism/test-ism-artifact-manager.js

@@ -0,0 +1,46 @@
+import { AltVM } from '@recoillink/provider-sdk';
+import { ArtifactState, } from '@recoillink/provider-sdk/artifact';
+import { assert } from '@recoillink/utils';
+import { getIsmType, getNoopIsmConfig } from './ism-query.js';
+import { getCreateNoopIsmTx } from './ism-tx.js';
+export class StarknetTestIsmReader {
+    provider;
+    constructor(provider) {
+        this.provider = provider;
+    }
+    async read(address) {
+        assert((await getIsmType(this.provider.getRawProvider(), address)) ===
+            AltVM.IsmType.TEST_ISM, `Expected a verified Starknet noop ISM at ${address}`);
+        const noop = getNoopIsmConfig(address);
+        return {
+            artifactState: ArtifactState.DEPLOYED,
+            config: { type: AltVM.IsmType.TEST_ISM },
+            deployed: { address: noop.address },
+        };
+    }
+}
+export class StarknetTestIsmWriter extends StarknetTestIsmReader {
+    signer;
+    constructor(provider, signer) {
+        super(provider);
+        this.signer = signer;
+    }
+    async create(artifact) {
+        const tx = getCreateNoopIsmTx();
+        const receipt = await this.signer.sendAndConfirmTransaction(tx);
+        const ismAddress = receipt.contractAddress;
+        assert(ismAddress, 'failed to deploy Starknet noop ISM');
+        return [
+            {
+                artifactState: ArtifactState.DEPLOYED,
+                config: artifact.config,
+                deployed: { address: ismAddress },
+            },
+            [receipt],
+        ];
+    }
+    async update(_artifact) {
+        return [];
+    }
+}
+//# sourceMappingURL=test-ism-artifact-manager.js.map

package/dist/ism/test-ism-artifact-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-ism-artifact-manager.js","sourceRoot":"","sources":["../../src/ism/test-ism-artifact-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AACjD,OAAO,EAIL,aAAa,GAEd,MAAM,mCAAmC,CAAC;AAS3C,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAI3C,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,OAAO,qBAAqB;IAID,QAAQ;IAAvC,YAA+B,QAA0B;wBAA1B,QAAQ;IAAqB,CAAC;IAE7D,KAAK,CAAC,IAAI,CACR,OAAe;QAIf,MAAM,CACJ,CAAC,MAAM,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE,EAAE,OAAO,CAAC,CAAC;YACzD,KAAK,CAAC,OAAO,CAAC,QAAQ,EACxB,4CAA4C,OAAO,EAAE,CACtD,CAAC;QACF,MAAM,IAAI,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QACvC,OAAO;YACL,aAAa,EAAE,aAAa,CAAC,QAAQ;YACrC,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE;YACxC,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE;SACpC,CAAC;IACJ,CAAC;CACF;AAED,MAAM,OAAO,qBACX,SAAQ,qBAAqB;IAMV,MAAM;IAFzB,YACE,QAA0B,EACT,MAAsB;QAEvC,KAAK,CAAC,QAAQ,CAAC,CAAC;sBAFC,MAAM;IAGzB,CAAC;IAED,KAAK,CAAC,MAAM,CACV,QAAuD;QAOvD,MAAM,EAAE,GAAG,kBAAkB,EAAE,CAAC;QAChC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,yBAAyB,CAAC,EAAE,CAAC,CAAC;QAChE,MAAM,UAAU,GAAG,OAAO,CAAC,eAAe,CAAC;QAC3C,MAAM,CAAC,UAAU,EAAE,oCAAoC,CAAC,CAAC;QACzD,OAAO;YACL;gBACE,aAAa,EAAE,aAAa,CAAC,QAAQ;gBACrC,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,QAAQ,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE;aAClC;YACD,CAAC,OAAO,CAAC;SACV,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,MAAM,CACV,SAGC;QAED,OAAO,EAAE,CAAC;IACZ,CAAC;CACF"}

package/dist/mailbox/mailbox-artifact-manager.d.ts

@@ -0,0 +1,15 @@
+import { ChainMetadataForAltVM } from '@recoillink/provider-sdk';
+import { ISigner } from '@recoillink/provider-sdk/altvm';
+import { ArtifactReader, ArtifactWriter } from '@recoillink/provider-sdk/artifact';
+import { DeployedMailboxAddress, DeployedRawMailboxArtifact, IRawMailboxArtifactManager, MailboxType, RawMailboxArtifactConfigs } from '@recoillink/provider-sdk/mailbox';
+import { AnnotatedTx, TxReceipt } from '@recoillink/provider-sdk/module';
+export declare class StarknetMailboxArtifactManager implements IRawMailboxArtifactManager {
+    private readonly chainMetadata;
+    private readonly provider;
+    constructor(chainMetadata: ChainMetadataForAltVM);
+    private requireStarknetSigner;
+    readMailbox(address: string): Promise<DeployedRawMailboxArtifact>;
+    createReader<T extends MailboxType>(type: T): ArtifactReader<RawMailboxArtifactConfigs[T], DeployedMailboxAddress>;
+    createWriter<T extends MailboxType>(type: T, signer: ISigner<AnnotatedTx, TxReceipt>): ArtifactWriter<RawMailboxArtifactConfigs[T], DeployedMailboxAddress>;
+}
+//# sourceMappingURL=mailbox-artifact-manager.d.ts.map

package/dist/mailbox/mailbox-artifact-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mailbox-artifact-manager.d.ts","sourceRoot":"","sources":["../../src/mailbox/mailbox-artifact-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAC;AACzD,OAAO,EAGL,cAAc,EAEd,cAAc,EACf,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,sBAAsB,EACtB,0BAA0B,EAC1B,0BAA0B,EAC1B,WAAW,EACX,yBAAyB,EAC1B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AA4OzE,qBAAa,8BAA+B,YAAW,0BAA0B;IAGnE,OAAO,CAAC,QAAQ,CAAC,aAAa;IAF1C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmB;IAE5C,YAA6B,aAAa,EAAE,qBAAqB,EAEhE;IAED,OAAO,CAAC,qBAAqB;IAOvB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAEtE;IAED,YAAY,CAAC,CAAC,SAAS,WAAW,EAChC,IAAI,EAAE,CAAC,GACN,cAAc,CAAC,yBAAyB,CAAC,CAAC,CAAC,EAAE,sBAAsB,CAAC,CAYtE;IAED,YAAY,CAAC,CAAC,SAAS,WAAW,EAChC,IAAI,EAAE,CAAC,EACP,MAAM,EAAE,OAAO,CAAC,WAAW,EAAE,SAAS,CAAC,GACtC,cAAc,CAAC,yBAAyB,CAAC,CAAC,CAAC,EAAE,sBAAsB,CAAC,CAiBtE;CACF"}

package/dist/mailbox/mailbox-artifact-manager.js

@@ -0,0 +1,179 @@
+import { ArtifactState, } from '@recoillink/provider-sdk/artifact';
+import { assert, eqAddressStarknet, isZeroishAddress } from '@recoillink/utils';
+import { StarknetProvider } from '../clients/provider.js';
+import { StarknetSigner } from '../clients/signer.js';
+import { normalizeStarknetAddressSafe } from '../contracts.js';
+import { getCreateNoopHookTx } from '../hook/hook-tx.js';
+import { getMailboxConfig } from './mailbox-query.js';
+import { getCreateMailboxTx, getSetDefaultHookTx, getSetDefaultIsmTx, getSetMailboxOwnerTx, getSetRequiredHookTx, } from './mailbox-tx.js';
+class StarknetMailboxReader {
+    provider;
+    constructor(provider) {
+        this.provider = provider;
+    }
+    async read(address) {
+        const mailbox = await getMailboxConfig(this.provider.getRawProvider(), address);
+        return {
+            artifactState: ArtifactState.DEPLOYED,
+            config: {
+                owner: mailbox.owner,
+                defaultIsm: {
+                    artifactState: ArtifactState.UNDERIVED,
+                    deployed: {
+                        address: normalizeStarknetAddressSafe(mailbox.defaultIsm),
+                    },
+                },
+                defaultHook: {
+                    artifactState: ArtifactState.UNDERIVED,
+                    deployed: {
+                        address: normalizeStarknetAddressSafe(mailbox.defaultHook),
+                    },
+                },
+                requiredHook: {
+                    artifactState: ArtifactState.UNDERIVED,
+                    deployed: {
+                        address: normalizeStarknetAddressSafe(mailbox.requiredHook),
+                    },
+                },
+            },
+            deployed: {
+                address: normalizeStarknetAddressSafe(mailbox.address),
+                domainId: mailbox.localDomain,
+            },
+        };
+    }
+}
+class StarknetMailboxWriter extends StarknetMailboxReader {
+    signer;
+    chainMetadata;
+    constructor(provider, signer, chainMetadata) {
+        super(provider);
+        this.signer = signer;
+        this.chainMetadata = chainMetadata;
+    }
+    getNestedAddress(nested) {
+        return normalizeStarknetAddressSafe(nested.deployed.address);
+    }
+    async getInitialHookAddress(address, receipts, placeholderRef) {
+        if (!isZeroishAddress(address)) {
+            return normalizeStarknetAddressSafe(address);
+        }
+        if (!placeholderRef.address) {
+            const tx = getCreateNoopHookTx();
+            const receipt = await this.signer.sendAndConfirmTransaction(tx);
+            receipts.push(receipt);
+            assert(receipt.contractAddress, 'failed to deploy placeholder Starknet noop hook');
+            placeholderRef.address = normalizeStarknetAddressSafe(receipt.contractAddress);
+        }
+        return placeholderRef.address;
+    }
+    async create(artifact) {
+        const defaultIsmAddress = this.getNestedAddress(artifact.config.defaultIsm);
+        const receipts = [];
+        const placeholderHookRef = {};
+        const defaultHookAddress = await this.getInitialHookAddress(this.getNestedAddress(artifact.config.defaultHook), receipts, placeholderHookRef);
+        const requiredHookAddress = await this.getInitialHookAddress(this.getNestedAddress(artifact.config.requiredHook), receipts, placeholderHookRef);
+        const createTx = getCreateMailboxTx(this.signer.getSignerAddress(), {
+            domainId: this.chainMetadata.domainId,
+            defaultIsmAddress,
+            defaultHookAddress,
+            requiredHookAddress,
+        });
+        const createReceipt = await this.signer.sendAndConfirmTransaction(createTx);
+        receipts.push(createReceipt);
+        assert(createReceipt.contractAddress, 'failed to deploy Starknet mailbox');
+        const mailboxAddress = createReceipt.contractAddress;
+        return [
+            {
+                artifactState: ArtifactState.DEPLOYED,
+                config: artifact.config,
+                deployed: {
+                    address: normalizeStarknetAddressSafe(mailboxAddress),
+                    domainId: this.chainMetadata.domainId,
+                },
+            },
+            receipts,
+        ];
+    }
+    async update(artifact) {
+        const current = await this.read(artifact.deployed.address);
+        const mailboxAddress = artifact.deployed.address;
+        const updateTxs = [];
+        const expectedDefaultIsm = this.getNestedAddress(artifact.config.defaultIsm);
+        const expectedDefaultHook = this.getNestedAddress(artifact.config.defaultHook);
+        const expectedRequiredHook = this.getNestedAddress(artifact.config.requiredHook);
+        const currentDefaultIsm = this.getNestedAddress(current.config.defaultIsm);
+        const currentDefaultHook = this.getNestedAddress(current.config.defaultHook);
+        const currentRequiredHook = this.getNestedAddress(current.config.requiredHook);
+        const rawProvider = this.signer.getRawProvider();
+        if (!eqAddressStarknet(currentDefaultIsm, expectedDefaultIsm)) {
+            updateTxs.push({
+                annotation: `Setting mailbox default ISM`,
+                ...(await getSetDefaultIsmTx(rawProvider, {
+                    mailboxAddress,
+                    ismAddress: expectedDefaultIsm,
+                })),
+            });
+        }
+        if (!eqAddressStarknet(currentDefaultHook, expectedDefaultHook)) {
+            updateTxs.push({
+                annotation: `Setting mailbox default hook`,
+                ...(await getSetDefaultHookTx(rawProvider, {
+                    mailboxAddress,
+                    hookAddress: expectedDefaultHook,
+                })),
+            });
+        }
+        if (!eqAddressStarknet(currentRequiredHook, expectedRequiredHook)) {
+            updateTxs.push({
+                annotation: `Setting mailbox required hook`,
+                ...(await getSetRequiredHookTx(rawProvider, {
+                    mailboxAddress,
+                    hookAddress: expectedRequiredHook,
+                })),
+            });
+        }
+        if (!eqAddressStarknet(current.config.owner, artifact.config.owner)) {
+            updateTxs.push({
+                annotation: `Setting mailbox owner`,
+                ...(await getSetMailboxOwnerTx(rawProvider, {
+                    mailboxAddress,
+                    newOwner: artifact.config.owner,
+                })),
+            });
+        }
+        return updateTxs;
+    }
+}
+export class StarknetMailboxArtifactManager {
+    chainMetadata;
+    provider;
+    constructor(chainMetadata) {
+        this.chainMetadata = chainMetadata;
+        this.provider = StarknetProvider.connect(chainMetadata);
+    }
+    requireStarknetSigner(signer) {
+        assert(signer instanceof StarknetSigner, 'Expected StarknetSigner');
+        return signer;
+    }
+    async readMailbox(address) {
+        return this.createReader('mailbox').read(address);
+    }
+    createReader(type) {
+        const readers = {
+            mailbox: new StarknetMailboxReader(this.provider),
+        };
+        const reader = readers[type];
+        assert(reader, 'Unsupported Starknet mailbox type');
+        return reader;
+    }
+    createWriter(type, signer) {
+        const writerFactories = {
+            mailbox: () => new StarknetMailboxWriter(this.provider, this.requireStarknetSigner(signer), this.chainMetadata),
+        };
+        const writerFactory = writerFactories[type];
+        assert(writerFactory, 'Unsupported Starknet mailbox type');
+        return writerFactory();
+    }
+}
+//# sourceMappingURL=mailbox-artifact-manager.js.map

package/dist/mailbox/mailbox-artifact-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mailbox-artifact-manager.js","sourceRoot":"","sources":["../../src/mailbox/mailbox-artifact-manager.ts"],"names":[],"mappings":"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"}

package/dist/mailbox/mailbox-artifact-manager.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mailbox-artifact-manager.test.d.ts.map

package/dist/mailbox/mailbox-artifact-manager.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mailbox-artifact-manager.test.d.ts","sourceRoot":"","sources":["../../src/mailbox/mailbox-artifact-manager.test.ts"],"names":[],"mappings":""}

package/dist/mailbox/mailbox-artifact-manager.test.js

@@ -0,0 +1,100 @@
+import { expect } from 'chai';
+import { RpcProvider } from 'starknet';
+import { ProtocolType } from '@recoillink/provider-sdk';
+import { ArtifactState } from '@recoillink/provider-sdk/artifact';
+import { StarknetSigner } from '../clients/signer.js';
+import { normalizeStarknetAddressSafe } from '../contracts.js';
+import { StarknetMailboxArtifactManager } from './mailbox-artifact-manager.js';
+describe('StarknetMailboxArtifactManager', () => {
+    const chainMetadata = {
+        name: 'starknetsepolia',
+        protocol: ProtocolType.Starknet,
+        chainId: 'SN_SEPOLIA',
+        domainId: 421614,
+        rpcUrls: [{ http: 'http://localhost:9545' }],
+    };
+    class MockStarknetSigner extends StarknetSigner {
+        sentTxs = [];
+        constructor() {
+            super(new RpcProvider({ nodeUrl: 'http://localhost:9545' }), chainMetadata, ['http://localhost:9545'], '0x1', '0x1111111111111111111111111111111111111111111111111111111111111111');
+        }
+        async sendAndConfirmTransaction(tx) {
+            this.sentTxs.push(tx);
+            const contractAddress = tx.kind === 'deploy' && tx.contractName === 'hook' ? '0xdef' : '0xabc';
+            return { transactionHash: `0x${this.sentTxs.length}`, contractAddress };
+        }
+    }
+    it('throws for unsupported mailbox reader type', () => {
+        const manager = new StarknetMailboxArtifactManager(chainMetadata);
+        expect(() => {
+            // @ts-expect-error testing runtime validation for unsupported value
+            manager.createReader('unsupported');
+        }).to.throw(/Unsupported Starknet mailbox type/i);
+    });
+    it('throws for unsupported mailbox writer type', () => {
+        const manager = new StarknetMailboxArtifactManager(chainMetadata);
+        expect(() => {
+            // @ts-expect-error testing runtime validation for unsupported value
+            manager.createWriter('unsupported', {});
+        }).to.throw(/Unsupported Starknet mailbox type/i);
+    });
+    it('creates mailbox artifacts without re-reading on-chain state', async () => {
+        const manager = new StarknetMailboxArtifactManager(chainMetadata);
+        const signer = new MockStarknetSigner();
+        const provider = Reflect.get(manager, 'provider');
+        provider.getMailbox = async () => {
+            throw new Error('unexpected mailbox read');
+        };
+        const writer = manager.createWriter('mailbox', signer);
+        const [artifact, receipts] = await writer.create({
+            artifactState: ArtifactState.NEW,
+            config: {
+                owner: signer.getSignerAddress(),
+                defaultIsm: {
+                    artifactState: ArtifactState.UNDERIVED,
+                    deployed: { address: '0x111' },
+                },
+                defaultHook: {
+                    artifactState: ArtifactState.UNDERIVED,
+                    deployed: { address: '0x222' },
+                },
+                requiredHook: {
+                    artifactState: ArtifactState.UNDERIVED,
+                    deployed: { address: '0x333' },
+                },
+            },
+        });
+        expect(receipts).to.have.length(1);
+        expect(artifact.deployed.address).to.equal(normalizeStarknetAddressSafe('0xabc'));
+        expect(artifact.deployed.domainId).to.equal(chainMetadata.domainId);
+    });
+    it('deploys a noop placeholder hook when Starknet mailbox hooks are unset', async () => {
+        const manager = new StarknetMailboxArtifactManager(chainMetadata);
+        const signer = new MockStarknetSigner();
+        const writer = manager.createWriter('mailbox', signer);
+        const [artifact, receipts] = await writer.create({
+            artifactState: ArtifactState.NEW,
+            config: {
+                owner: signer.getSignerAddress(),
+                defaultIsm: {
+                    artifactState: ArtifactState.UNDERIVED,
+                    deployed: { address: '0x111' },
+                },
+                defaultHook: {
+                    artifactState: ArtifactState.UNDERIVED,
+                    deployed: { address: '0x0' },
+                },
+                requiredHook: {
+                    artifactState: ArtifactState.UNDERIVED,
+                    deployed: { address: '0x0' },
+                },
+            },
+        });
+        expect(receipts).to.have.length(2);
+        expect(signer.sentTxs).to.have.length(2);
+        expect(signer.sentTxs[0]?.kind).to.equal('deploy');
+        expect(signer.sentTxs[1]?.kind).to.equal('deploy');
+        expect(artifact.deployed.address).to.equal(normalizeStarknetAddressSafe('0xabc'));
+    });
+});
+//# sourceMappingURL=mailbox-artifact-manager.test.js.map

package/dist/mailbox/mailbox-artifact-manager.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mailbox-artifact-manager.test.js","sourceRoot":"","sources":["../../src/mailbox/mailbox-artifact-manager.test.ts"],"names":[],"mappings":"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"}

package/dist/mailbox/mailbox-query.d.ts

@@ -0,0 +1,13 @@
+import { type RpcProvider } from 'starknet';
+export interface StarknetMailboxConfig {
+    address: string;
+    owner: string;
+    localDomain: number;
+    defaultIsm: string;
+    defaultHook: string;
+    requiredHook: string;
+    nonce: number;
+}
+export declare function getMailboxConfig(provider: RpcProvider, mailboxAddress: string): Promise<StarknetMailboxConfig>;
+export declare function isMessageDelivered(provider: RpcProvider, mailboxAddress: string, messageId: string): Promise<boolean>;
+//# sourceMappingURL=mailbox-query.d.ts.map

package/dist/mailbox/mailbox-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mailbox-query.d.ts","sourceRoot":"","sources":["../../src/mailbox/mailbox-query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,UAAU,CAAC;AAW5C,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,WAAW,EACrB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,qBAAqB,CAAC,CA0BhC;AAED,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,WAAW,EACrB,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,CAAC,CASlB"}

package/dist/mailbox/mailbox-query.js

@@ -0,0 +1,29 @@
+import { StarknetContractName, callContract, getStarknetContract, normalizeStarknetAddressSafe, toBigInt, toNumber, } from '../contracts.js';
+export async function getMailboxConfig(provider, mailboxAddress) {
+    const mailbox = getStarknetContract(StarknetContractName.MAILBOX, mailboxAddress, provider);
+    const [owner, localDomain, defaultIsm, defaultHook, requiredHook, nonce] = await Promise.all([
+        callContract(mailbox, 'owner'),
+        callContract(mailbox, 'get_local_domain'),
+        callContract(mailbox, 'get_default_ism'),
+        callContract(mailbox, 'get_default_hook'),
+        callContract(mailbox, 'get_required_hook'),
+        callContract(mailbox, 'nonce'),
+    ]);
+    return {
+        address: normalizeStarknetAddressSafe(mailboxAddress),
+        owner: normalizeStarknetAddressSafe(owner),
+        localDomain: toNumber(localDomain),
+        defaultIsm: normalizeStarknetAddressSafe(defaultIsm),
+        defaultHook: normalizeStarknetAddressSafe(defaultHook),
+        requiredHook: normalizeStarknetAddressSafe(requiredHook),
+        nonce: toNumber(nonce),
+    };
+}
+export async function isMessageDelivered(provider, mailboxAddress, messageId) {
+    const mailbox = getStarknetContract(StarknetContractName.MAILBOX, mailboxAddress, provider);
+    const delivered = await callContract(mailbox, 'delivered', [messageId]);
+    if (typeof delivered === 'boolean')
+        return delivered;
+    return toBigInt(delivered) !== 0n;
+}
+//# sourceMappingURL=mailbox-query.js.map

package/dist/mailbox/mailbox-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mailbox-query.js","sourceRoot":"","sources":["../../src/mailbox/mailbox-query.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,oBAAoB,EACpB,YAAY,EACZ,mBAAmB,EACnB,4BAA4B,EAC5B,QAAQ,EACR,QAAQ,GACT,MAAM,iBAAiB,CAAC;AAYzB,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,QAAqB,EACrB,cAAsB;IAEtB,MAAM,OAAO,GAAG,mBAAmB,CACjC,oBAAoB,CAAC,OAAO,EAC5B,cAAc,EACd,QAAQ,CACT,CAAC;IAEF,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,KAAK,CAAC,GACtE,MAAM,OAAO,CAAC,GAAG,CAAC;QAChB,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC;QAC9B,YAAY,CAAC,OAAO,EAAE,kBAAkB,CAAC;QACzC,YAAY,CAAC,OAAO,EAAE,iBAAiB,CAAC;QACxC,YAAY,CAAC,OAAO,EAAE,kBAAkB,CAAC;QACzC,YAAY,CAAC,OAAO,EAAE,mBAAmB,CAAC;QAC1C,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC;KAC/B,CAAC,CAAC;IAEL,OAAO;QACL,OAAO,EAAE,4BAA4B,CAAC,cAAc,CAAC;QACrD,KAAK,EAAE,4BAA4B,CAAC,KAAK,CAAC;QAC1C,WAAW,EAAE,QAAQ,CAAC,WAAW,CAAC;QAClC,UAAU,EAAE,4BAA4B,CAAC,UAAU,CAAC;QACpD,WAAW,EAAE,4BAA4B,CAAC,WAAW,CAAC;QACtD,YAAY,EAAE,4BAA4B,CAAC,YAAY,CAAC;QACxD,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC;KACvB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,QAAqB,EACrB,cAAsB,EACtB,SAAiB;IAEjB,MAAM,OAAO,GAAG,mBAAmB,CACjC,oBAAoB,CAAC,OAAO,EAC5B,cAAc,EACd,QAAQ,CACT,CAAC;IACF,MAAM,SAAS,GAAG,MAAM,YAAY,CAAC,OAAO,EAAE,WAAW,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;IACxE,IAAI,OAAO,SAAS,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACrD,OAAO,QAAQ,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;AACpC,CAAC"}

package/dist/mailbox/mailbox-tx.d.ts

@@ -0,0 +1,25 @@
+import { type RpcProvider } from 'starknet';
+import { type StarknetAnnotatedTx } from '../types.js';
+export declare function getCreateMailboxTx(signer: string, config: {
+    domainId: number;
+    defaultIsmAddress?: string;
+    defaultHookAddress?: string;
+    requiredHookAddress?: string;
+}): StarknetAnnotatedTx;
+export declare function getSetDefaultIsmTx(provider: RpcProvider, config: {
+    mailboxAddress: string;
+    ismAddress: string;
+}): Promise<StarknetAnnotatedTx>;
+export declare function getSetDefaultHookTx(provider: RpcProvider, config: {
+    mailboxAddress: string;
+    hookAddress: string;
+}): Promise<StarknetAnnotatedTx>;
+export declare function getSetRequiredHookTx(provider: RpcProvider, config: {
+    mailboxAddress: string;
+    hookAddress: string;
+}): Promise<StarknetAnnotatedTx>;
+export declare function getSetMailboxOwnerTx(provider: RpcProvider, config: {
+    mailboxAddress: string;
+    newOwner: string;
+}): Promise<StarknetAnnotatedTx>;
+//# sourceMappingURL=mailbox-tx.d.ts.map

package/dist/mailbox/mailbox-tx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mailbox-tx.d.ts","sourceRoot":"","sources":["../../src/mailbox/mailbox-tx.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,UAAU,CAAC;AAU5C,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE;IACN,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B,GACA,mBAAmB,CAkBrB;AAED,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,WAAW,EACrB,MAAM,EAAE;IACN,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB,GACA,OAAO,CAAC,mBAAmB,CAAC,CAS9B;AAED,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,WAAW,EACrB,MAAM,EAAE;IACN,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;CACrB,GACA,OAAO,CAAC,mBAAmB,CAAC,CAS9B;AAED,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,WAAW,EACrB,MAAM,EAAE;IACN,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;CACrB,GACA,OAAO,CAAC,mBAAmB,CAAC,CAS9B;AAED,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,WAAW,EACrB,MAAM,EAAE;IACN,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;CAClB,GACA,OAAO,CAAC,mBAAmB,CAAC,CAS9B"}

package/dist/mailbox/mailbox-tx.js

@@ -0,0 +1,40 @@
+import { ZERO_ADDRESS_HEX_32 } from '@recoillink/utils';
+import { StarknetContractName, getStarknetContract, normalizeStarknetAddressSafe, populateInvokeTx, } from '../contracts.js';
+export function getCreateMailboxTx(signer, config) {
+    return {
+        kind: 'deploy',
+        contractName: StarknetContractName.MAILBOX,
+        constructorArgs: [
+            config.domainId,
+            normalizeStarknetAddressSafe(signer),
+            normalizeStarknetAddressSafe(config.defaultIsmAddress ?? ZERO_ADDRESS_HEX_32),
+            normalizeStarknetAddressSafe(config.defaultHookAddress ?? ZERO_ADDRESS_HEX_32),
+            normalizeStarknetAddressSafe(config.requiredHookAddress ?? ZERO_ADDRESS_HEX_32),
+        ],
+    };
+}
+export async function getSetDefaultIsmTx(provider, config) {
+    const mailbox = getStarknetContract(StarknetContractName.MAILBOX, config.mailboxAddress, provider);
+    return populateInvokeTx(mailbox, 'set_default_ism', [
+        normalizeStarknetAddressSafe(config.ismAddress),
+    ]);
+}
+export async function getSetDefaultHookTx(provider, config) {
+    const mailbox = getStarknetContract(StarknetContractName.MAILBOX, config.mailboxAddress, provider);
+    return populateInvokeTx(mailbox, 'set_default_hook', [
+        normalizeStarknetAddressSafe(config.hookAddress),
+    ]);
+}
+export async function getSetRequiredHookTx(provider, config) {
+    const mailbox = getStarknetContract(StarknetContractName.MAILBOX, config.mailboxAddress, provider);
+    return populateInvokeTx(mailbox, 'set_required_hook', [
+        normalizeStarknetAddressSafe(config.hookAddress),
+    ]);
+}
+export async function getSetMailboxOwnerTx(provider, config) {
+    const mailbox = getStarknetContract(StarknetContractName.MAILBOX, config.mailboxAddress, provider);
+    return populateInvokeTx(mailbox, 'transfer_ownership', [
+        normalizeStarknetAddressSafe(config.newOwner),
+    ]);
+}
+//# sourceMappingURL=mailbox-tx.js.map

package/dist/mailbox/mailbox-tx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mailbox-tx.js","sourceRoot":"","sources":["../../src/mailbox/mailbox-tx.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExD,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,4BAA4B,EAC5B,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AAGzB,MAAM,UAAU,kBAAkB,CAChC,MAAc,EACd,MAKC;IAED,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,YAAY,EAAE,oBAAoB,CAAC,OAAO;QAC1C,eAAe,EAAE;YACf,MAAM,CAAC,QAAQ;YACf,4BAA4B,CAAC,MAAM,CAAC;YACpC,4BAA4B,CAC1B,MAAM,CAAC,iBAAiB,IAAI,mBAAmB,CAChD;YACD,4BAA4B,CAC1B,MAAM,CAAC,kBAAkB,IAAI,mBAAmB,CACjD;YACD,4BAA4B,CAC1B,MAAM,CAAC,mBAAmB,IAAI,mBAAmB,CAClD;SACF;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,QAAqB,EACrB,MAGC;IAED,MAAM,OAAO,GAAG,mBAAmB,CACjC,oBAAoB,CAAC,OAAO,EAC5B,MAAM,CAAC,cAAc,EACrB,QAAQ,CACT,CAAC;IACF,OAAO,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,EAAE;QAClD,4BAA4B,CAAC,MAAM,CAAC,UAAU,CAAC;KAChD,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,QAAqB,EACrB,MAGC;IAED,MAAM,OAAO,GAAG,mBAAmB,CACjC,oBAAoB,CAAC,OAAO,EAC5B,MAAM,CAAC,cAAc,EACrB,QAAQ,CACT,CAAC;IACF,OAAO,gBAAgB,CAAC,OAAO,EAAE,kBAAkB,EAAE;QACnD,4BAA4B,CAAC,MAAM,CAAC,WAAW,CAAC;KACjD,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,QAAqB,EACrB,MAGC;IAED,MAAM,OAAO,GAAG,mBAAmB,CACjC,oBAAoB,CAAC,OAAO,EAC5B,MAAM,CAAC,cAAc,EACrB,QAAQ,CACT,CAAC;IACF,OAAO,gBAAgB,CAAC,OAAO,EAAE,mBAAmB,EAAE;QACpD,4BAA4B,CAAC,MAAM,CAAC,WAAW,CAAC;KACjD,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,QAAqB,EACrB,MAGC;IAED,MAAM,OAAO,GAAG,mBAAmB,CACjC,oBAAoB,CAAC,OAAO,EAC5B,MAAM,CAAC,cAAc,EACrB,QAAQ,CACT,CAAC;IACF,OAAO,gBAAgB,CAAC,OAAO,EAAE,oBAAoB,EAAE;QACrD,4BAA4B,CAAC,MAAM,CAAC,QAAQ,CAAC;KAC9C,CAAC,CAAC;AACL,CAAC"}

package/dist/runtime.d.ts

@@ -0,0 +1,4 @@
+export { StarknetProtocolProvider } from './clients/protocol.js';
+export { StarknetProvider } from './clients/provider.js';
+export { StarknetSigner } from './clients/signer.js';
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/runtime.js

@@ -0,0 +1,4 @@
+export { StarknetProtocolProvider } from './clients/protocol.js';
+export { StarknetProvider } from './clients/provider.js';
+export { StarknetSigner } from './clients/signer.js';
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/testing/constants.d.ts

@@ -0,0 +1,8 @@
+import { TestChainMetadata } from '@recoillink/provider-sdk/chain';
+export declare const DEFAULT_E2E_TEST_TIMEOUT = 300000;
+export declare const STARKNET_DEVNET_IMAGE = "shardlabs/starknet-devnet-rs";
+export declare const STARKNET_DEVNET_TAG = "0.4.2";
+export declare const TEST_STARKNET_PRIVATE_KEY = "0x0000000000000000000000000000000071d7bb07b9a64f6f78ac4c816aff4da9";
+export declare const TEST_STARKNET_ACCOUNT_ADDRESS = "0x064b48806902a367c8598f4f95c305e8c1a1acba5f082d294a43793113115691";
+export declare const TEST_STARKNET_CHAIN_METADATA: TestChainMetadata;
+//# sourceMappingURL=constants.d.ts.map

package/dist/testing/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/testing/constants.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAEnE,eAAO,MAAM,wBAAwB,SAAU,CAAC;AAEhD,eAAO,MAAM,qBAAqB,iCAAiC,CAAC;AACpE,eAAO,MAAM,mBAAmB,UAAU,CAAC;AAE3C,eAAO,MAAM,yBAAyB,uEACgC,CAAC;AACvE,eAAO,MAAM,6BAA6B,uEAC4B,CAAC;AAEvE,eAAO,MAAM,4BAA4B,EAAE,iBAmB1C,CAAC"}