@humanode-hyperlane/starknet-sdk 0.0.0-stage → 27.2.3

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

@@ -0,0 +1,128 @@
+import { expect } from 'chai';
+import { RpcProvider } from 'starknet';
+import { ProtocolType } from '@humanode-hyperlane/provider-sdk';
+import { ArtifactState } from '@humanode-hyperlane/provider-sdk/artifact';
+import { TokenType } from '@humanode-hyperlane/provider-sdk/warp';
+import { ZERO_ADDRESS_HEX_32 } from '@humanode-hyperlane/utils';
+import { StarknetSigner } from '../clients/signer.js';
+import { normalizeStarknetAddressSafe } from '../contracts.js';
+import { StarknetWarpArtifactManager } from './warp-artifact-manager.js';
+describe('StarknetWarpArtifactManager', () => {
+    const chainMetadata = {
+        name: 'starknetsepolia',
+        protocol: ProtocolType.Starknet,
+        chainId: 'SN_SEPOLIA',
+        domainId: 421614,
+        rpcUrls: [{ http: 'http://localhost:9545' }],
+    };
+    class MockStarknetSigner extends StarknetSigner {
+        capturedTxs = [];
+        constructor() {
+            super(new RpcProvider({ nodeUrl: 'http://localhost:9545' }), chainMetadata, ['http://localhost:9545'], '0x1', '0x1111111111111111111111111111111111111111111111111111111111111111');
+        }
+        async sendAndConfirmTransaction(tx) {
+            this.capturedTxs.push(tx);
+            return {
+                transactionHash: `0x${this.capturedTxs.length}`,
+                contractAddress: tx.kind === 'deploy' ? '0xabc' : undefined,
+            };
+        }
+        async getMailbox(_req) {
+            return {
+                address: '0x111',
+                localDomain: chainMetadata.domainId,
+                nonce: 0,
+                owner: this.getSignerAddress(),
+                defaultIsm: '0x333',
+                defaultHook: '0x222',
+                requiredHook: '0x222',
+            };
+        }
+    }
+    it('creates native warp artifacts without re-reading on-chain state', async () => {
+        const manager = new StarknetWarpArtifactManager(chainMetadata);
+        const signer = new MockStarknetSigner();
+        const provider = Reflect.get(manager, 'provider');
+        provider.getToken = async () => {
+            throw new Error('unexpected token read');
+        };
+        const writer = manager.createWriter('native', signer);
+        const [artifact, receipts] = await writer.create({
+            artifactState: ArtifactState.NEW,
+            config: {
+                type: TokenType.native,
+                owner: signer.getSignerAddress(),
+                mailbox: '0x111',
+                remoteRouters: {},
+                destinationGas: {},
+            },
+        });
+        expect(receipts).to.have.length(1);
+        expect(signer.capturedTxs).to.have.length(1);
+        expect(signer.capturedTxs[0]?.kind).to.equal('deploy');
+        expect(artifact.deployed.address).to.equal(normalizeStarknetAddressSafe('0xabc'));
+    });
+    it('preserves current hook and ism when Starknet updates omit them', async () => {
+        const manager = new StarknetWarpArtifactManager(chainMetadata);
+        const signer = new MockStarknetSigner();
+        const provider = Reflect.get(manager, 'provider');
+        provider.getToken = async () => ({
+            address: '0xabc',
+            tokenType: TokenType.native,
+            owner: signer.getSignerAddress(),
+            mailboxAddress: '0x111',
+            ismAddress: '0x444',
+            hookAddress: '0x555',
+        });
+        provider.getRemoteRouters = async () => ({ remoteRouters: [] });
+        const writer = manager.createWriter('native', signer);
+        const txs = await writer.update({
+            artifactState: ArtifactState.DEPLOYED,
+            deployed: { address: '0xabc' },
+            config: {
+                type: TokenType.native,
+                owner: signer.getSignerAddress(),
+                mailbox: '0x111',
+                remoteRouters: {},
+                destinationGas: {},
+            },
+        });
+        expect(txs).to.be.empty;
+    });
+    it('treats zero-address hook and ism placeholders as unset on Starknet update', async () => {
+        const manager = new StarknetWarpArtifactManager(chainMetadata);
+        const signer = new MockStarknetSigner();
+        const provider = Reflect.get(manager, 'provider');
+        provider.getToken = async () => ({
+            address: '0xabc',
+            tokenType: TokenType.native,
+            owner: signer.getSignerAddress(),
+            mailboxAddress: '0x111',
+            ismAddress: '0x444',
+            hookAddress: '0x555',
+        });
+        provider.getRemoteRouters = async () => ({ remoteRouters: [] });
+        const writer = manager.createWriter('native', signer);
+        const txs = await writer.update({
+            artifactState: ArtifactState.DEPLOYED,
+            deployed: { address: '0xabc' },
+            config: {
+                type: TokenType.native,
+                owner: signer.getSignerAddress(),
+                mailbox: '0x111',
+                interchainSecurityModule: {
+                    artifactState: ArtifactState.UNDERIVED,
+                    deployed: { address: ZERO_ADDRESS_HEX_32 },
+                },
+                hook: {
+                    artifactState: ArtifactState.UNDERIVED,
+                    deployed: { address: ZERO_ADDRESS_HEX_32 },
+                },
+                remoteRouters: {},
+                destinationGas: {},
+            },
+        });
+        expect(txs).to.be.empty;
+    });
+});
+//# sourceMappingURL=warp-artifact-manager.test.js.map

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

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

package/package.json

@@ -1,6 +1,56 @@
 {
   "name": "@humanode-hyperlane/starknet-sdk",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "27.2.3",
+  "description": "Hyperlane TypeScript SDK for Starknet artifact API support",
+  "keywords": [
+    "blockchain",
+    "hyperlane",
+    "sdk",
+    "starknet"
+  ],
+  "homepage": "https://www.hyperlane.xyz",
+  "license": "Apache-2.0",
+  "repository": "https://github.com/humanode-network/hyperlane-monorepo",
+  "files": [
+    "/dist"
+  ],
+  "type": "module",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./testing": {
+      "types": "./dist/testing/index.d.ts",
+      "default": "./dist/testing/index.js"
+    }
+  },
+  "dependencies": {
+    "starknet": "^7.4.0",
+    "@humanode-hyperlane/provider-sdk": "4.2.3",
+    "@humanode-hyperlane/starknet-core": "30.0.0",
+    "@humanode-hyperlane/utils": "30.0.0"
+  },
+  "devDependencies": {
+    "@types/chai": "^4.3.11",
+    "@types/mocha": "^10.0.1",
+    "@types/node": "^24.10.9",
+    "chai": "^4.5.0",
+    "mocha": "^11.5.0",
+    "testcontainers": "11.12.0",
+    "tsx": "^4.19.1",
+    "typescript": "6.0.2",
+    "@humanode-hyperlane/tsconfig": "^30.0.0"
+  },
+  "scripts": {
+    "build": "rm -rf ./dist && tsc",
+    "format": "oxfmt --write ./src",
+    "lint": "oxlint -c ../../oxlint.json",
+    "clean": "rm -rf ./dist ./cache",
+    "dev": "tsc --watch",
+    "test": "mocha --config .mocharc.json",
+    "test:e2e": "./scripts/run-e2e-test.sh",
+    "test:ci": "pnpm test"
+  }
 }

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.