@recoillink/sdk 0.0.0-stage → 45.0.1

package/dist/signers/turnkeyClient.js

@@ -0,0 +1,121 @@
+import { ApiKeyStamper } from '@turnkey/api-key-stamper';
+import { TurnkeyServerClient } from '@turnkey/sdk-server';
+import { z } from 'zod';
+import { deepCopy, rootLogger } from '@recoillink/utils';
+const logger = rootLogger.child({ module: 'sdk:turnkey-client' });
+/**
+ * Extract safe error message from error object
+ * Avoids logging sensitive data like API keys, stack traces, etc.
+ * Handles TurnkeyActivityError, TurnkeyRequestError, and standard Error types
+ */
+function getSafeErrorMessage(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return 'Unknown error';
+}
+/**
+ * Log Turnkey operation error safely without exposing sensitive data
+ * Accepts unknown errors from catch blocks and safely extracts error messages
+ */
+export function logTurnkeyError(operation, error) {
+    const errorMessage = getSafeErrorMessage(error);
+    logger.error(`${operation}:`, errorMessage);
+}
+/**
+ * Validate that a Turnkey activity completed successfully
+ * The Turnkey SDK polls internally until the activity completes or max retries are reached.
+ * If we receive a non-completed status, it indicates an SDK bug or request error.
+ */
+export function validateTurnkeyActivityCompleted(activity, operationType) {
+    if (activity.status !== 'ACTIVITY_STATUS_COMPLETED') {
+        throw new Error(`${operationType} activity did not complete. Status: ${activity.status}`);
+    }
+}
+/**
+ * Default Turnkey API base URL
+ */
+export const DEFAULT_TURNKEY_API_BASE_URL = 'https://api.turnkey.com';
+/**
+ * Unified Turnkey configuration for both Sealevel and EVM keys
+ * The publicKey field contains:
+ * - For Sealevel: base58-encoded Solana public key
+ * - For EVM: hex-encoded Ethereum address
+ *
+ * The optional apiBaseUrl defaults to {@link DEFAULT_TURNKEY_API_BASE_URL}.
+ */
+export const TurnkeyConfigSchema = z.object({
+    organizationId: z.string(),
+    apiPublicKey: z.string(),
+    apiPrivateKey: z.string(),
+    privateKeyId: z.string(),
+    publicKey: z.string(),
+    apiBaseUrl: z.string().optional(),
+});
+/**
+ * Shared Turnkey client manager
+ * Handles initialization, health checks, and provides access to the Turnkey client
+ *
+ * This class is used by all VM-specific signers via composition rather than inheritance,
+ * allowing each signer to extend/implement their VM-specific base classes while
+ * still sharing common Turnkey functionality.
+ *
+ * @example
+ * ```typescript
+ * const manager = new TurnkeyClientManager(config);
+ * await manager.healthCheck();
+ * const client = manager.getClient();
+ * ```
+ */
+export class TurnkeyClientManager {
+    client;
+    config;
+    constructor(config) {
+        this.config = config;
+        const stamper = new ApiKeyStamper({
+            apiPublicKey: config.apiPublicKey,
+            apiPrivateKey: config.apiPrivateKey,
+        });
+        this.client = new TurnkeyServerClient({
+            organizationId: config.organizationId,
+            stamper,
+            apiBaseUrl: config.apiBaseUrl || DEFAULT_TURNKEY_API_BASE_URL,
+        });
+    }
+    /**
+     * Get a copy of the configuration (for creating new signer instances)
+     */
+    getConfig() {
+        return deepCopy(this.config);
+    }
+    /**
+     * Get the Turnkey client (for signing operations)
+     */
+    getClient() {
+        return this.client;
+    }
+    /**
+     * Get organization ID
+     */
+    getOrganizationId() {
+        return this.config.organizationId;
+    }
+    /**
+     * Check if Turnkey is properly configured and accessible
+     */
+    async healthCheck() {
+        try {
+            logger.debug('Running Turnkey health check...');
+            const whoami = await this.client.getWhoami({
+                organizationId: this.config.organizationId,
+            });
+            logger.debug(`Turnkey health check passed. Organization ID: ${whoami.organizationId}`);
+            return true;
+        }
+        catch (error) {
+            logTurnkeyError('Turnkey health check failed', error);
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=turnkeyClient.js.map

package/dist/signers/turnkeyClient.js.map

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

package/dist/signers/types.d.ts

@@ -0,0 +1,8 @@
+import { Address, ProtocolType } from '@recoillink/utils';
+import { SendTransactionOptions } from '../providers/MultiProvider.js';
+import { ProtocolTypedTransaction } from '../providers/ProviderType.js';
+export interface IMultiProtocolSigner<TProtocol extends ProtocolType> {
+    address(): Promise<Address>;
+    sendAndConfirmTransaction(tx: ProtocolTypedTransaction<TProtocol>, options?: SendTransactionOptions): Promise<string>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/signers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/signers/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AAExE,MAAM,WAAW,oBAAoB,CAAC,SAAS,SAAS,YAAY;IAClE,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5B,yBAAyB,CACvB,EAAE,EAAE,wBAAwB,CAAC,SAAS,CAAC,EACvC,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,MAAM,CAAC,CAAC;CACpB"}

package/dist/signers/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/signers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/signers/types.ts"],"names":[],"mappings":""}

package/dist/test/contractDouble.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Builds a typed partial double of `T`, typically a typechain factory's
+ * `connect` return. The provided members are type-checked against the real `T`
+ * (so a misspelled or removed member is a compile error); only the final
+ * widening — which sinon's `.returns`/`.resolves` requires — is cast.
+ */
+export declare function contractDouble<T>(members: Partial<T>): T;
+//# sourceMappingURL=contractDouble.d.ts.map

package/dist/test/contractDouble.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contractDouble.d.ts","sourceRoot":"","sources":["../../src/test/contractDouble.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAIxD"}

package/dist/test/contractDouble.js

@@ -0,0 +1,12 @@
+/**
+ * Builds a typed partial double of `T`, typically a typechain factory's
+ * `connect` return. The provided members are type-checked against the real `T`
+ * (so a misspelled or removed member is a compile error); only the final
+ * widening — which sinon's `.returns`/`.resolves` requires — is cast.
+ */
+export function contractDouble(members) {
+    // CAST: sinon's `.returns` needs the exact contract type; `members` is a
+    // partial test double whose keys are validated against `T` above.
+    return members;
+}
+//# sourceMappingURL=contractDouble.js.map

package/dist/test/contractDouble.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contractDouble.js","sourceRoot":"","sources":["../../src/test/contractDouble.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAI,OAAmB;IACnD,yEAAyE;IACzE,kEAAkE;IAClE,OAAO,OAAY,CAAC;AACtB,CAAC"}

package/dist/test/contractStubs.d.ts

@@ -0,0 +1,8 @@
+import sinon from 'sinon';
+/**
+ * Stubs `PackageVersioned__factory.connect` so callers exercise only the
+ * `PACKAGE_VERSION()` read that `fetchPackageVersion` performs.
+ * Note: callers should call `sandbox.restore()` after tests complete.
+ */
+export declare function stubPackageVersion(sandbox: sinon.SinonSandbox, packageVersion: () => Promise<string>): void;
+//# sourceMappingURL=contractStubs.d.ts.map

package/dist/test/contractStubs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contractStubs.d.ts","sourceRoot":"","sources":["../../src/test/contractStubs.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,KAAK,CAAC,YAAY,EAC3B,cAAc,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,GACpC,IAAI,CAON"}

package/dist/test/contractStubs.js

@@ -0,0 +1,15 @@
+import { PackageVersioned__factory } from '@recoillink/core';
+/**
+ * Stubs `PackageVersioned__factory.connect` so callers exercise only the
+ * `PACKAGE_VERSION()` read that `fetchPackageVersion` performs.
+ * Note: callers should call `sandbox.restore()` after tests complete.
+ */
+export function stubPackageVersion(sandbox, packageVersion) {
+    // CAST: connect() returns the fully generated PackageVersioned contract type;
+    // the code under test only invokes PACKAGE_VERSION(), so stubbing the entire
+    // contract is impractical and we narrow to the single method being read.
+    sandbox.stub(PackageVersioned__factory, 'connect').returns({
+        PACKAGE_VERSION: packageVersion,
+    });
+}
+//# sourceMappingURL=contractStubs.js.map

package/dist/test/contractStubs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contractStubs.js","sourceRoot":"","sources":["../../src/test/contractStubs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAG7D;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAA2B,EAC3B,cAAqC;IAErC,8EAA8E;IAC9E,6EAA6E;IAC7E,yEAAyE;IACzE,OAAO,CAAC,IAAI,CAAC,yBAAyB,EAAE,SAAS,CAAC,CAAC,OAAO,CAAC;QACzD,eAAe,EAAE,cAAc;KACwB,CAAC,CAAC;AAC7D,CAAC"}

package/dist/test/errors.d.ts

@@ -0,0 +1,34 @@
+export declare function missingSelectorError(): Error & {
+    code: string;
+    data: string;
+};
+export declare function networkError(): Error & {
+    code: string;
+};
+export declare function wrappedError(cause: Error): Error;
+export declare function panicRevertError(): Error & {
+    code: string;
+    data: string;
+};
+export declare function errorStringRevertError(): Error & {
+    code: string;
+    data: string;
+};
+export declare function lsp17NoExtensionError(): Error & {
+    code: string;
+    data: string;
+};
+export declare function unrecognisedCustomRevertError(): Error & {
+    code: string;
+    data: string;
+};
+/**
+ * Shape of the CALL_EXCEPTION ethers v5 JsonRpcProvider throws for an eth_call
+ * that failed without revert data: data "0x" with the original error nested.
+ */
+export declare function ethersCallExceptionWithNestedError(nested: object): Error & {
+    code: string;
+    data: string;
+    error: object;
+};
+//# sourceMappingURL=errors.d.ts.map

package/dist/test/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/test/errors.ts"],"names":[],"mappings":"AAAA,wBAAgB,oBAAoB,IAAI,KAAK,GAAG;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd,CAKA;AAED,wBAAgB,YAAY,IAAI,KAAK,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAIvD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,CAEhD;AAED,wBAAgB,gBAAgB,IAAI,KAAK,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAKzE;AAED,wBAAgB,sBAAsB,IAAI,KAAK,GAAG;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd,CAKA;AAED,wBAAgB,qBAAqB,IAAI,KAAK,GAAG;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd,CAKA;AAED,wBAAgB,6BAA6B,IAAI,KAAK,GAAG;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd,CAKA;AAED;;;GAGG;AACH,wBAAgB,kCAAkC,CAChD,MAAM,EAAE,MAAM,GACb,KAAK,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAOvD"}

package/dist/test/errors.js

@@ -0,0 +1,46 @@
+export function missingSelectorError() {
+    return Object.assign(new Error('call revert exception (data="0x")'), {
+        code: 'CALL_EXCEPTION',
+        data: '0x',
+    });
+}
+export function networkError() {
+    return Object.assign(new Error('provider unavailable'), {
+        code: 'NETWORK_ERROR',
+    });
+}
+export function wrappedError(cause) {
+    return new Error('wrapped provider error', { cause });
+}
+export function panicRevertError() {
+    return Object.assign(new Error('call revert exception'), {
+        code: 'CALL_EXCEPTION',
+        data: `0x4e487b71${'0'.repeat(62)}11`,
+    });
+}
+export function errorStringRevertError() {
+    return Object.assign(new Error('call revert exception'), {
+        code: 'CALL_EXCEPTION',
+        data: `0x08c379a0${'0'.repeat(62)}20${'0'.repeat(62)}06${'706175736564'}${'0'.repeat(52)}`,
+    });
+}
+export function lsp17NoExtensionError() {
+    return Object.assign(new Error('call revert exception'), {
+        code: 'CALL_EXCEPTION',
+        data: `0xbb370b2b46904840${'0'.repeat(56)}`,
+    });
+}
+export function unrecognisedCustomRevertError() {
+    return Object.assign(new Error('call revert exception'), {
+        code: 'CALL_EXCEPTION',
+        data: `0xdeadbeef${'0'.repeat(64)}`,
+    });
+}
+/**
+ * Shape of the CALL_EXCEPTION ethers v5 JsonRpcProvider throws for an eth_call
+ * that failed without revert data: data "0x" with the original error nested.
+ */
+export function ethersCallExceptionWithNestedError(nested) {
+    return Object.assign(new Error('missing revert data in call exception; Transaction reverted without a reason string [ See: https://links.ethers.org/v5-errors-CALL_EXCEPTION ] (data="0x", transaction={}, error={}, code=CALL_EXCEPTION, version=providers/5.8.0)'), { code: 'CALL_EXCEPTION', data: '0x', error: nested });
+}
+//# sourceMappingURL=errors.js.map

package/dist/test/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/test/errors.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,oBAAoB;IAIlC,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,mCAAmC,CAAC,EAAE;QACnE,IAAI,EAAE,gBAAgB;QACtB,IAAI,EAAE,IAAI;KACX,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,sBAAsB,CAAC,EAAE;QACtD,IAAI,EAAE,eAAe;KACtB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAY;IACvC,OAAO,IAAI,KAAK,CAAC,wBAAwB,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,uBAAuB,CAAC,EAAE;QACvD,IAAI,EAAE,gBAAgB;QACtB,IAAI,EAAE,aAAa,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI;KACtC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,sBAAsB;IAIpC,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,uBAAuB,CAAC,EAAE;QACvD,IAAI,EAAE,gBAAgB;QACtB,IAAI,EAAE,aAAa,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,cAAc,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE;KAC3F,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,qBAAqB;IAInC,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,uBAAuB,CAAC,EAAE;QACvD,IAAI,EAAE,gBAAgB;QACtB,IAAI,EAAE,qBAAqB,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE;KAC5C,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,6BAA6B;IAI3C,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,uBAAuB,CAAC,EAAE;QACvD,IAAI,EAAE,gBAAgB;QACtB,IAAI,EAAE,aAAa,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE;KACpC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kCAAkC,CAChD,MAAc;IAEd,OAAO,MAAM,CAAC,MAAM,CAClB,IAAI,KAAK,CACP,oOAAoO,CACrO,EACD,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CACtD,CAAC;AACJ,CAAC"}

package/dist/test/fixtures/warp-route-replay/record.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=record.d.ts.map

package/dist/test/fixtures/warp-route-replay/record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record.d.ts","sourceRoot":"","sources":["../../../../src/test/fixtures/warp-route-replay/record.ts"],"names":[],"mappings":""}

package/dist/test/fixtures/warp-route-replay/record.js

@@ -0,0 +1,32 @@
+// Re-records a replay fixture from a live node:
+//   RPC_URL=<node url> pnpm exec tsx src/test/fixtures/warp-route-replay/record.ts <scenario>
+// RPC_URL is read from the environment only and never written to the fixture.
+// eslint-disable-next-line import/no-nodejs-modules
+import { writeFileSync } from 'fs';
+import { assert } from '@recoillink/utils';
+import { REPLAY_FIXTURE_DIR, createReplayReader, serializeReplayFixture, startRecordingServer, } from '../../replayRpc.js';
+import { REPLAY_SCENARIOS, runProbe } from '../../replayScenarios.js';
+const [scenarioName] = process.argv.slice(2);
+const upstream = process.env.RPC_URL;
+assert(upstream, 'RPC_URL is required');
+const scenario = REPLAY_SCENARIOS.find((s) => s.scenario === scenarioName);
+assert(scenario, `Unknown scenario ${scenarioName}`);
+const recorder = await startRecordingServer(upstream, {
+    scenario: scenario.scenario,
+    chain: scenario.chain,
+    chainId: scenario.chainId,
+});
+try {
+    const { reader, provider } = createReplayReader(recorder.url, scenario.chainId);
+    const result = await scenario.run(reader, scenario.router);
+    console.log(`${scenario.scenario}:`, result);
+    for (const probe of scenario.probes) {
+        await runProbe(provider, probe).catch((error) => console.log(`probe ${probe.signature} threw: ${String(error).slice(0, 80)}`));
+    }
+    assert(recorder.failures.length === 0, `Recording server failures: ${recorder.failures.join('; ')}`);
+    writeFileSync(new URL(`${scenario.scenario}.json`, REPLAY_FIXTURE_DIR), serializeReplayFixture(recorder.fixture));
+}
+finally {
+    await recorder.close();
+}
+//# sourceMappingURL=record.js.map

package/dist/test/fixtures/warp-route-replay/record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"record.js","sourceRoot":"","sources":["../../../../src/test/fixtures/warp-route-replay/record.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,8FAA8F;AAC9F,8EAA8E;AAC9E,oDAAoD;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AAEnC,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEtE,MAAM,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAC7C,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;AACrC,MAAM,CAAC,QAAQ,EAAE,qBAAqB,CAAC,CAAC;AACxC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,YAAY,CAAC,CAAC;AAC3E,MAAM,CAAC,QAAQ,EAAE,oBAAoB,YAAY,EAAE,CAAC,CAAC;AAErD,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,QAAQ,EAAE;IACpD,QAAQ,EAAE,QAAQ,CAAC,QAAQ;IAC3B,KAAK,EAAE,QAAQ,CAAC,KAAK;IACrB,OAAO,EAAE,QAAQ,CAAC,OAAO;CAC1B,CAAC,CAAC;AACH,IAAI,CAAC;IACH,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,kBAAkB,CAC7C,QAAQ,CAAC,GAAG,EACZ,QAAQ,CAAC,OAAO,CACjB,CAAC;IACF,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC3D,OAAO,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,QAAQ,GAAG,EAAE,MAAM,CAAC,CAAC;IAC7C,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;QACpC,MAAM,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE,CACvD,OAAO,CAAC,GAAG,CACT,SAAS,KAAK,CAAC,SAAS,WAAW,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAChE,CACF,CAAC;IACJ,CAAC;IACD,MAAM,CACJ,QAAQ,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAC9B,8BAA8B,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC7D,CAAC;IACF,aAAa,CACX,IAAI,GAAG,CAAC,GAAG,QAAQ,CAAC,QAAQ,OAAO,EAAE,kBAAkB,CAAC,EACxD,sBAAsB,CAAC,QAAQ,CAAC,OAAO,CAAC,CACzC,CAAC;AACJ,CAAC;QAAS,CAAC;IACT,MAAM,QAAQ,CAAC,KAAK,EAAE,CAAC;AACzB,CAAC"}

package/dist/test/multiProviderStubs.d.ts

@@ -0,0 +1,9 @@
+import sinon from 'sinon';
+import { MultiProtocolProvider } from '../providers/MultiProtocolProvider.js';
+/**
+ * Takes a MultiProtocolProvider instance and stubs it's get*Provider methods to
+ * return mock providers. More provider methods can be added her as needed.
+ * Note: callers should call `sandbox.restore()` after tests complete.
+ */
+export declare function stubMultiProtocolProvider(multiProvider: MultiProtocolProvider): sinon.SinonSandbox;
+//# sourceMappingURL=multiProviderStubs.d.ts.map

package/dist/test/multiProviderStubs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multiProviderStubs.d.ts","sourceRoot":"","sources":["../../src/test/multiProviderStubs.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAE9E;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,aAAa,EAAE,qBAAqB,GACnC,KAAK,CAAC,YAAY,CAsBpB"}

package/dist/test/multiProviderStubs.js

@@ -0,0 +1,31 @@
+import { TOKEN_2022_PROGRAM_ID } from '@solana/spl-token';
+import sinon from 'sinon';
+/**
+ * Takes a MultiProtocolProvider instance and stubs it's get*Provider methods to
+ * return mock providers. More provider methods can be added her as needed.
+ * Note: callers should call `sandbox.restore()` after tests complete.
+ */
+export function stubMultiProtocolProvider(multiProvider) {
+    const sandbox = sinon.createSandbox();
+    sandbox.stub(multiProvider, 'getEthersV5Provider').returns({
+        getBalance: async () => '100',
+    });
+    sandbox.stub(multiProvider, 'getCosmJsProvider').returns({
+        getBalance: async () => ({ amount: '100' }),
+    });
+    sandbox.stub(multiProvider, 'getCosmJsWasmProvider').returns({
+        getBalance: async () => ({ amount: '100' }),
+        queryContractSmart: async () => ({
+            type: { native: { fungible: { denom: 'denom' } } },
+        }),
+    });
+    sandbox.stub(multiProvider, 'getSolanaWeb3Provider').returns({
+        getBalance: async () => '100',
+        getTokenAccountBalance: async () => ({ value: { amount: '100' } }),
+        getAccountInfo: async () => ({
+            owner: TOKEN_2022_PROGRAM_ID,
+        }),
+    });
+    return sandbox;
+}
+//# sourceMappingURL=multiProviderStubs.js.map

package/dist/test/multiProviderStubs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"multiProviderStubs.js","sourceRoot":"","sources":["../../src/test/multiProviderStubs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CACvC,aAAoC;IAEpC,MAAM,OAAO,GAAG,KAAK,CAAC,aAAa,EAAE,CAAC;IACtC,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,qBAAqB,CAAC,CAAC,OAAO,CAAC;QACzD,UAAU,EAAE,KAAK,IAAI,EAAE,CAAC,KAAK;KACvB,CAAC,CAAC;IACV,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,mBAAmB,CAAC,CAAC,OAAO,CAAC;QACvD,UAAU,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;KACrC,CAAC,CAAC;IACV,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,uBAAuB,CAAC,CAAC,OAAO,CAAC;QAC3D,UAAU,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QAC3C,kBAAkB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;YAC/B,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE;SACnD,CAAC;KACI,CAAC,CAAC;IACV,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,uBAAuB,CAAC,CAAC,OAAO,CAAC;QAC3D,UAAU,EAAE,KAAK,IAAI,EAAE,CAAC,KAAK;QAC7B,sBAAsB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;QAClE,cAAc,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;YAC3B,KAAK,EAAE,qBAAqB;SAC7B,CAAC;KACI,CAAC,CAAC;IACV,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/test/replayRpc.d.ts

@@ -0,0 +1,82 @@
+import type { providers } from 'ethers';
+import { EvmWarpRouteReader } from '../token/EvmWarpRouteReader.js';
+export declare const REPLAY_FIXTURE_DIR: URL;
+export declare const REPLAY_CHAIN_NAME = "replaychain";
+export interface JsonRpcErrorBody {
+    code: number;
+    message: string;
+    data?: unknown;
+}
+export interface RecordedRequest {
+    method: string;
+    address?: string;
+    slot?: string;
+    to?: string;
+    data?: string;
+    result?: string;
+    resultGzBase64?: string;
+    error?: JsonRpcErrorBody;
+}
+export interface ReplayFixture {
+    scenario: string;
+    chain: string;
+    chainId: number;
+    blockNumber: number;
+    capturedAt: string;
+    requests: RecordedRequest[];
+}
+export declare function serializeReplayFixture(fixture: ReplayFixture): string;
+export declare function parseReplayFixture(text: string): ReplayFixture;
+export declare function loadReplayFixture(scenario: string): ReplayFixture;
+export declare function recordedResult(request: RecordedRequest): string | undefined;
+export declare function recordedCode(fixture: ReplayFixture, address: string): string | undefined;
+/**
+ * Derives a variant of a recording by replacing the recorded response of the
+ * eth_call to `to` with calldata starting with `dataPrefix`. Variants are
+ * synthetic: only the replaced response is not a recording.
+ */
+export declare function withCallResult(fixture: ReplayFixture, to: string, dataPrefix: string, result: string): ReplayFixture;
+/**
+ * Derives a variant of a recording by replacing the recorded response of the
+ * eth_call to `to` with calldata starting with `dataPrefix` by a JSON-RPC
+ * error.
+ */
+export declare function withCallError(fixture: ReplayFixture, to: string, dataPrefix: string, error: JsonRpcErrorBody): ReplayFixture;
+/**
+ * Derives a variant of a recording whose storage `slot` at `address` reads as
+ * `value`, adding the read when it was not recorded.
+ */
+export declare function withStorage(fixture: ReplayFixture, address: string, slot: string, value: string): ReplayFixture;
+/**
+ * Derives a variant of a recording whose contract code at `address` has
+ * `hexSuffix` appended.
+ */
+export declare function withCodeSuffix(fixture: ReplayFixture, address: string, hexSuffix: string): ReplayFixture;
+export interface ReplayServer {
+    url: string;
+    ethCalls: string[];
+    unexpected: string[];
+    close(): Promise<void>;
+}
+/**
+ * Serves the recorded JSON-RPC responses (results and error bodies exactly as
+ * recorded). Requests without a recording are answered with an error and listed
+ * in `unexpected`.
+ */
+export declare function startReplayServer(fixture: ReplayFixture): Promise<ReplayServer>;
+export interface RecordingServer {
+    url: string;
+    fixture: ReplayFixture;
+    failures: string[];
+    close(): Promise<void>;
+}
+/**
+ * Forwards requests to a real node and records the eth_getCode,
+ * eth_getStorageAt, eth_call and eth_estimateGas responses.
+ */
+export declare function startRecordingServer(upstreamUrl: string, meta: Pick<ReplayFixture, 'scenario' | 'chain' | 'chainId'>): Promise<RecordingServer>;
+export declare function createReplayReader(rpcUrl: string, chainId: number): {
+    reader: EvmWarpRouteReader;
+    provider: providers.Provider;
+};
+//# sourceMappingURL=replayRpc.d.ts.map

package/dist/test/replayRpc.d.ts.map

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