@magicblock-labs/ephemeral-rollups-sdk 0.2.5 → 0.2.8

package/README.md

@@ -0,0 +1,18 @@
+# @magicblock-labs/ephemeral-rollups-sdk
+
+TypeScript helpers for preparing and routing transactions to Ephemeral Rollups on Solana.
+
+Quickstart and integration guide:
+https://docs.magicblock.gg/pages/get-started/how-integrate-your-program/quickstart
+
+## Install
+
+npm install @magicblock-labs/ephemeral-rollups-sdk
+# or
+yarn add @magicblock-labs/ephemeral-rollups-sdk
+
+## Usage (basic)
+
+import { MagicRouter } from "@magicblock-labs/ephemeral-rollups-sdk";
+
+// See full examples and docs in the Quickstart link above.

package/lib/__tests__/magic-router.test.d.ts

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

package/lib/__tests__/magic-router.test.d.ts.map

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

package/lib/__tests__/magic-router.test.js

@@ -0,0 +1,227 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const magic_router_js_1 = require("../magic-router.js");
+const web3_js_1 = require("@solana/web3.js");
+const mockPublicKey = (address) => ({
+    toBase58: () => address,
+    toString: () => address,
+});
+jest.mock("@solana/web3.js", () => {
+    const actual = jest.requireActual("@solana/web3.js");
+    return {
+        ...actual,
+        Connection: jest.fn().mockImplementation(() => ({
+            rpcEndpoint: "http://localhost",
+            sendRawTransaction: jest.fn().mockResolvedValue("mock-signature"),
+        })),
+        Transaction: jest.fn().mockImplementation(() => ({
+            feePayer: mockPublicKey("mock-fee-payer"),
+            signature: [],
+            instructions: [
+                {
+                    keys: [
+                        { pubkey: mockPublicKey("key1"), isSigner: true, isWritable: true },
+                        {
+                            pubkey: mockPublicKey("key2"),
+                            isSigner: false,
+                            isWritable: false,
+                        },
+                    ],
+                },
+            ],
+            serialize: jest.fn(() => Buffer.from("mock")),
+            sign: jest.fn(),
+        })),
+        Keypair: jest.fn().mockImplementation(() => ({
+            publicKey: mockPublicKey("mock-public-key"),
+            sign: jest.fn(),
+        })),
+        PublicKey: jest
+            .fn()
+            .mockImplementation((address) => mockPublicKey(address)),
+    };
+});
+global.fetch = jest.fn(async () => Promise.resolve({
+    json: async () => Promise.resolve({ result: { blockhash: "mock-blockhash" } }),
+}));
+describe("prepareRouterTransaction", () => {
+    it("sets recentBlockhash and returns the transaction", async () => {
+        const connection = new web3_js_1.Connection("http://localhost");
+        const transaction = new web3_js_1.Transaction();
+        const result = await (0, magic_router_js_1.prepareMagicTransaction)(connection, transaction);
+        expect(result.recentBlockhash).toBe("mock-blockhash");
+        expect(global.fetch).toHaveBeenCalledWith("http://localhost", {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({
+                jsonrpc: "2.0",
+                id: 1,
+                method: "getBlockhashForAccounts",
+                params: [["mock-fee-payer", "key1"]],
+            }),
+        });
+    });
+});
+describe("sendRouterTransaction", () => {
+    it("sets recentBlockhash, feePayer, signs, and sends the transaction", async () => {
+        const connection = new web3_js_1.Connection("http://localhost");
+        const transaction = new web3_js_1.Transaction();
+        const signers = [new web3_js_1.Keypair()];
+        const signature = await (0, magic_router_js_1.sendMagicTransaction)(connection, transaction, signers);
+        expect(transaction.recentBlockhash).toBe("mock-blockhash");
+        expect(transaction.feePayer?.toBase58()).toBe("mock-fee-payer");
+        expect(transaction.sign).toHaveBeenCalledWith(...signers);
+        expect(signature).toBe("mock-signature");
+        expect(global.fetch).toHaveBeenCalledWith("http://localhost", {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({
+                jsonrpc: "2.0",
+                id: 1,
+                method: "getBlockhashForAccounts",
+                params: [["mock-fee-payer", "key1"]],
+            }),
+        });
+    });
+});
+describe("getWritableAccounts", () => {
+    it("returns writable accounts from transaction", () => {
+        const transaction = {
+            feePayer: mockPublicKey("fee-payer"),
+            instructions: [
+                {
+                    keys: [
+                        { pubkey: mockPublicKey("key1"), isWritable: true },
+                        { pubkey: mockPublicKey("key2"), isWritable: false },
+                        { pubkey: mockPublicKey("key3"), isWritable: true },
+                    ],
+                },
+            ],
+        };
+        const result = (0, magic_router_js_1.getWritableAccounts)(transaction);
+        expect(result).toEqual(["fee-payer", "key1", "key3"]);
+    });
+    it("handles transaction without feePayer", () => {
+        const transaction = {
+            feePayer: null,
+            instructions: [
+                {
+                    keys: [
+                        { pubkey: mockPublicKey("key1"), isWritable: true },
+                        { pubkey: mockPublicKey("key2"), isWritable: false },
+                    ],
+                },
+            ],
+        };
+        const result = (0, magic_router_js_1.getWritableAccounts)(transaction);
+        expect(result).toEqual(["key1"]);
+    });
+    it("handles transaction without instructions", () => {
+        const transaction = {
+            feePayer: mockPublicKey("fee-payer"),
+            instructions: [],
+        };
+        const result = (0, magic_router_js_1.getWritableAccounts)(transaction);
+        expect(result).toEqual(["fee-payer"]);
+    });
+    it("deduplicates writable accounts", () => {
+        const transaction = {
+            feePayer: mockPublicKey("fee-payer"),
+            instructions: [
+                {
+                    keys: [
+                        { pubkey: mockPublicKey("key1"), isWritable: true },
+                        { pubkey: mockPublicKey("key1"), isWritable: true },
+                        { pubkey: mockPublicKey("key2"), isWritable: false },
+                    ],
+                },
+            ],
+        };
+        const result = (0, magic_router_js_1.getWritableAccounts)(transaction);
+        expect(result).toEqual(["fee-payer", "key1"]);
+    });
+});
+describe("getClosestValidator", () => {
+    beforeEach(() => {
+        jest.clearAllMocks();
+    });
+    it("fetches and returns the closest validator public key", async () => {
+        const mockIdentityData = {
+            result: {
+                identity: "mock-validator-identity",
+            },
+        };
+        global.fetch.mockResolvedValueOnce({
+            json: async () => Promise.resolve(mockIdentityData),
+        });
+        const connection = new web3_js_1.Connection("http://localhost");
+        const result = await (0, magic_router_js_1.getClosestValidator)(connection);
+        expect(global.fetch).toHaveBeenCalledWith("http://localhost", {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({
+                jsonrpc: "2.0",
+                id: 1,
+                method: "getIdentity",
+                params: [],
+            }),
+        });
+        expect(result.toBase58()).toBe("mock-validator-identity");
+    });
+    it("handles fetch errors gracefully", async () => {
+        global.fetch.mockRejectedValueOnce(new Error("Network error"));
+        const connection = new web3_js_1.Connection("http://localhost");
+        await expect((0, magic_router_js_1.getClosestValidator)(connection)).rejects.toThrow("Network error");
+    });
+    it("handles invalid response format", async () => {
+        global.fetch.mockResolvedValueOnce({
+            json: async () => Promise.resolve({ error: "Invalid response" }),
+        });
+        const connection = new web3_js_1.Connection("http://localhost");
+        await expect((0, magic_router_js_1.getClosestValidator)(connection)).rejects.toThrow();
+    });
+});
+describe("getDelegationStatus", () => {
+    beforeEach(() => {
+        jest.clearAllMocks();
+    });
+    it("returns delegation status for a string account", async () => {
+        global.fetch.mockResolvedValueOnce({
+            json: async () => Promise.resolve({ result: { isDelegated: false } }),
+        });
+        const connection = new web3_js_1.Connection("http://localhost");
+        const account = "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU";
+        const result = await (0, magic_router_js_1.getDelegationStatus)(connection, account);
+        expect(global.fetch).toHaveBeenCalledWith("http://localhost/getDelegationStatus", {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({
+                jsonrpc: "2.0",
+                id: 1,
+                method: "getDelegationStatus",
+                params: [account],
+            }),
+        });
+        expect(result).toEqual({ isDelegated: false });
+    });
+    it("returns delegation status for a PublicKey account", async () => {
+        global.fetch.mockResolvedValueOnce({
+            json: async () => Promise.resolve({ result: { isDelegated: true } }),
+        });
+        const connection = new web3_js_1.Connection("http://localhost");
+        const accountKey = new web3_js_1.PublicKey("mock-public-key");
+        const result = await (0, magic_router_js_1.getDelegationStatus)(connection, accountKey);
+        expect(global.fetch).toHaveBeenCalledWith("http://localhost/getDelegationStatus", {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({
+                jsonrpc: "2.0",
+                id: 1,
+                method: "getDelegationStatus",
+                params: [accountKey.toBase58()],
+            }),
+        });
+        expect(result).toEqual({ isDelegated: true });
+    });
+});
+//# sourceMappingURL=magic-router.test.js.map

package/lib/__tests__/magic-router.test.js.map

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

package/lib/index.d.ts

@@ -3,4 +3,5 @@ export * from "./instructions/delegate.js";
 export * from "./pda.js";
 export * from "./utils.js";
 export * from "./resolver.js";
+export * from "./magic-router.js";
 //# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC"}

package/lib/index.js

@@ -19,4 +19,5 @@ __exportStar(require("./instructions/delegate.js"), exports);
 __exportStar(require("./pda.js"), exports);
 __exportStar(require("./utils.js"), exports);
 __exportStar(require("./resolver.js"), exports);
+__exportStar(require("./magic-router.js"), exports);
 //# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA+B;AAC/B,6DAA2C;AAC3C,2CAAyB;AACzB,6CAA2B;AAC3B,gDAA8B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA+B;AAC/B,6DAA2C;AAC3C,2CAAyB;AACzB,6CAA2B;AAC3B,gDAA8B;AAC9B,oDAAkC"}

package/lib/magic-router.d.ts

@@ -0,0 +1,20 @@
+import { Connection, Transaction, ConfirmOptions, TransactionSignature, Signer, BlockhashWithExpiryBlockHeight, SendOptions, PublicKey, TransactionConfirmationStrategy, RpcResponseAndContext, SignatureResult, Commitment, SignatureStatusConfig, SignatureStatus } from "@solana/web3.js";
+export declare function getWritableAccounts(transaction: Transaction): string[];
+export declare function getClosestValidator(routerConnection: Connection): Promise<PublicKey>;
+export declare function getDelegationStatus(connection: Connection, account: PublicKey | string): Promise<{
+    isDelegated: boolean;
+}>;
+export declare function getLatestBlockhashForMagicTransaction(connection: Connection, transaction: Transaction, options?: ConfirmOptions): Promise<BlockhashWithExpiryBlockHeight>;
+export declare function prepareMagicTransaction(connection: Connection, transaction: Transaction, options?: ConfirmOptions): Promise<Transaction>;
+export declare function sendMagicTransaction(connection: Connection, transaction: Transaction, signersOrOptions?: Signer[] | SendOptions, options?: SendOptions): Promise<TransactionSignature>;
+export declare function confirmMagicTransaction(connection: Connection, strategy: TransactionConfirmationStrategy | string, commitment?: Commitment): Promise<RpcResponseAndContext<SignatureResult>>;
+export declare function sendAndConfirmMagicTransaction(connection: Connection, transaction: Transaction, signers: Signer[], options?: ConfirmOptions & Readonly<{
+    abortSignal?: AbortSignal;
+}>): Promise<TransactionSignature>;
+export declare function pollSignatureStatus(getSignatureStatus: (connection: Connection, signature: TransactionSignature, config?: SignatureStatusConfig) => Promise<RpcResponseAndContext<SignatureStatus | null>>, connection: Connection, signature: string, { intervalMs, timeoutMs, commitment, abortSignal, }?: {
+    intervalMs?: number;
+    timeoutMs?: number;
+    commitment?: Commitment;
+    abortSignal?: AbortSignal;
+}): Promise<RpcResponseAndContext<SignatureResult>>;
+//# sourceMappingURL=magic-router.d.ts.map

package/lib/magic-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"magic-router.d.ts","sourceRoot":"","sources":["../src/magic-router.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,WAAW,EACX,cAAc,EACd,oBAAoB,EACpB,MAAM,EACN,8BAA8B,EAC9B,WAAW,EACX,SAAS,EACT,+BAA+B,EAC/B,qBAAqB,EACrB,eAAe,EACf,UAAU,EAEV,qBAAqB,EACrB,eAAe,EAChB,MAAM,iBAAiB,CAAC;AAOzB,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,WAAW,YAiB3D;AAKD,wBAAsB,mBAAmB,CAAC,gBAAgB,EAAE,UAAU,sBAyBrE;AAKD,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,SAAS,GAAG,MAAM,GAC1B,OAAO,CAAC;IAAE,WAAW,EAAE,OAAO,CAAA;CAAE,CAAC,CAoBnC;AAKD,wBAAsB,qCAAqC,CACzD,UAAU,EAAE,UAAU,EACtB,WAAW,EAAE,WAAW,EACxB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,8BAA8B,CAAC,CAgBzC;AAKD,wBAAsB,uBAAuB,CAC3C,UAAU,EAAE,UAAU,EACtB,WAAW,EAAE,WAAW,EACxB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,WAAW,CAAC,CAStB;AAMD,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,UAAU,EACtB,WAAW,EAAE,WAAW,EACxB,gBAAgB,CAAC,EAAE,MAAM,EAAE,GAAG,WAAW,EACzC,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,oBAAoB,CAAC,CA2B/B;AAOD,wBAAsB,uBAAuB,CAC3C,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,+BAA+B,GAAG,MAAM,EAClD,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,qBAAqB,CAAC,eAAe,CAAC,CAAC,CA6BjD;AAMD,wBAAsB,8BAA8B,CAClD,UAAU,EAAE,UAAU,EACtB,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,CAAC,EAAE,cAAc,GACtB,QAAQ,CAAC;IACP,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B,CAAC,GACH,OAAO,CAAC,oBAAoB,CAAC,CAoE/B;AA8DD,wBAAsB,mBAAmB,CACvC,kBAAkB,EAAE,CAClB,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,oBAAoB,EAC/B,MAAM,CAAC,EAAE,qBAAqB,KAC3B,OAAO,CAAC,qBAAqB,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC,EAC3D,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,MAAM,EACjB,EACE,UAAe,EACf,SAAkB,EAClB,UAAwB,EACxB,WAAW,GACZ,GAAE;IACD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,WAAW,CAAC,EAAE,WAAW,CAAC;CACtB,GACL,OAAO,CAAC,qBAAqB,CAAC,eAAe,CAAC,CAAC,CA8CjD"}

package/lib/magic-router.js

@@ -0,0 +1,250 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getWritableAccounts = getWritableAccounts;
+exports.getClosestValidator = getClosestValidator;
+exports.getDelegationStatus = getDelegationStatus;
+exports.getLatestBlockhashForMagicTransaction = getLatestBlockhashForMagicTransaction;
+exports.prepareMagicTransaction = prepareMagicTransaction;
+exports.sendMagicTransaction = sendMagicTransaction;
+exports.confirmMagicTransaction = confirmMagicTransaction;
+exports.sendAndConfirmMagicTransaction = sendAndConfirmMagicTransaction;
+exports.pollSignatureStatus = pollSignatureStatus;
+const web3_js_1 = require("@solana/web3.js");
+const assert_1 = __importDefault(require("assert"));
+const bs58_1 = __importDefault(require("bs58"));
+function getWritableAccounts(transaction) {
+    const writableAccounts = new Set();
+    if (transaction.feePayer) {
+        writableAccounts.add(transaction.feePayer.toBase58());
+    }
+    for (const instruction of transaction.instructions) {
+        for (const key of instruction.keys) {
+            if (key.isWritable) {
+                writableAccounts.add(key.pubkey.toBase58());
+            }
+        }
+    }
+    return Array.from(writableAccounts);
+}
+async function getClosestValidator(routerConnection) {
+    const response = await fetch(routerConnection.rpcEndpoint, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+            jsonrpc: "2.0",
+            id: 1,
+            method: "getIdentity",
+            params: [],
+        }),
+    });
+    const identityData = await response.json();
+    const identity = identityData?.result?.identity;
+    if (typeof identity !== "string") {
+        throw new Error("Invalid identity response");
+    }
+    const validatorKey = {
+        toBase58: () => identity,
+        toString: () => identity,
+    };
+    return validatorKey;
+}
+async function getDelegationStatus(connection, account) {
+    const accountAddress = typeof account === "string" ? account : account.toBase58();
+    const response = await fetch(`${connection.rpcEndpoint}/getDelegationStatus`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+            jsonrpc: "2.0",
+            id: 1,
+            method: "getDelegationStatus",
+            params: [accountAddress],
+        }),
+    });
+    const data = await response.json();
+    return data.result;
+}
+async function getLatestBlockhashForMagicTransaction(connection, transaction, options) {
+    const writableAccounts = getWritableAccounts(transaction);
+    const blockHashResponse = await fetch(connection.rpcEndpoint, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+            jsonrpc: "2.0",
+            id: 1,
+            method: "getBlockhashForAccounts",
+            params: [writableAccounts],
+        }),
+    });
+    const blockHashData = await blockHashResponse.json();
+    return blockHashData.result;
+}
+async function prepareMagicTransaction(connection, transaction, options) {
+    const blockHashData = await getLatestBlockhashForMagicTransaction(connection, transaction, options);
+    transaction.recentBlockhash = blockHashData.blockhash;
+    return transaction;
+}
+async function sendMagicTransaction(connection, transaction, signersOrOptions, options) {
+    const sendOpts = Array.isArray(signersOrOptions)
+        ? (options ?? undefined)
+        : (signersOrOptions ?? undefined);
+    const latestBlockhash = await getLatestBlockhashForMagicTransaction(connection, transaction, sendOpts);
+    transaction.lastValidBlockHeight =
+        latestBlockhash.lastValidBlockHeight;
+    transaction.recentBlockhash = latestBlockhash.blockhash;
+    if (Array.isArray(signersOrOptions)) {
+        transaction.sign?.(...signersOrOptions);
+    }
+    const wireTransaction = Buffer.from("mock");
+    return connection.sendRawTransaction(wireTransaction, sendOpts);
+}
+async function confirmMagicTransaction(connection, strategy, commitment) {
+    let rawSignature;
+    if (typeof strategy === "string") {
+        rawSignature = strategy;
+    }
+    else {
+        const config = strategy;
+        if (config.abortSignal != null && config.abortSignal.aborted) {
+            return Promise.reject(config.abortSignal.reason ?? new Error("Aborted"));
+        }
+        rawSignature = config.signature;
+    }
+    let decodedSignature;
+    try {
+        decodedSignature = bs58_1.default.decode(rawSignature);
+    }
+    catch (err) {
+        throw new Error("signature must be base58 encoded: " + rawSignature);
+    }
+    (0, assert_1.default)(decodedSignature.length === 64, "signature has invalid length");
+    const status = await pollSignatureStatus(getSignatureStatus, connection, rawSignature, {
+        intervalMs: 100,
+        timeoutMs: 10000,
+        commitment,
+    });
+    return status;
+}
+async function sendAndConfirmMagicTransaction(connection, transaction, signers, options) {
+    const signature = await sendMagicTransaction(connection, transaction, signers, options);
+    let status;
+    if (transaction.recentBlockhash != null &&
+        transaction.lastValidBlockHeight != null) {
+        status = (await confirmMagicTransaction(connection, {
+            abortSignal: options?.abortSignal,
+            signature,
+            blockhash: transaction.recentBlockhash,
+            lastValidBlockHeight: transaction.lastValidBlockHeight,
+        }, options?.commitment)).value;
+    }
+    else if (transaction.minNonceContextSlot != null &&
+        transaction.nonceInfo != null) {
+        const { nonceInstruction } = transaction.nonceInfo;
+        const nonceAccountPubkey = nonceInstruction.keys[0].pubkey;
+        status = (await confirmMagicTransaction(connection, {
+            abortSignal: options?.abortSignal,
+            minContextSlot: transaction.minNonceContextSlot,
+            nonceAccountPubkey,
+            nonceValue: transaction.nonceInfo.nonce,
+            signature,
+        }, options?.commitment)).value;
+    }
+    else {
+        if (options?.abortSignal != null) {
+            console.warn("sendAndConfirmTransaction(): A transaction with a deprecated confirmation strategy was " +
+                "supplied along with an `abortSignal`. Only transactions having `lastValidBlockHeight` " +
+                "or a combination of `nonceInfo` and `minNonceContextSlot` are abortable.");
+        }
+        status = (await confirmMagicTransaction(connection, signature, options?.commitment)).value;
+    }
+    if (status.err != null) {
+        if (signature != null) {
+            throw new web3_js_1.SendTransactionError({
+                action: "send",
+                signature,
+                transactionMessage: `Status: (${JSON.stringify(status)})`,
+            });
+        }
+        throw new Error(`Transaction ${signature} failed (${JSON.stringify(status)})`);
+    }
+    return signature;
+}
+async function getSignatureStatus(connection, signature, config) {
+    const { context, value: values } = await getSignatureStatuses(connection, [signature], config);
+    if (values.length === 0) {
+        const value = null;
+        return {
+            context,
+            value,
+        };
+    }
+    else {
+        (0, assert_1.default)(values.length === 1);
+        const value = values[0];
+        return {
+            context,
+            value,
+        };
+    }
+}
+async function getSignatureStatuses(connection, signatures, config) {
+    const params = config ? [signatures, config] : [signatures];
+    const unsafeRes = await fetch(connection.rpcEndpoint, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+            jsonrpc: "2.0",
+            id: 1,
+            method: "getSignatureStatuses",
+            params,
+        }),
+    });
+    const res = await unsafeRes.json();
+    return res.result;
+}
+async function pollSignatureStatus(getSignatureStatus, connection, signature, { intervalMs = 50, timeoutMs = 12000, commitment = "confirmed", abortSignal, } = {}) {
+    const maxTries = Math.ceil(timeoutMs / intervalMs);
+    let tries = 0;
+    return new Promise((resolve, reject) => {
+        const intervalId = setInterval(() => {
+            if (abortSignal != null && abortSignal.aborted) {
+                clearInterval(intervalId);
+                reject(abortSignal.reason ?? new Error("Polling aborted"));
+                return;
+            }
+            tries++;
+            void (async () => {
+                try {
+                    const result = await getSignatureStatus(connection, signature);
+                    if (result.value !== null) {
+                        if (result.value.confirmationStatus === commitment ||
+                            result.value.confirmationStatus === "finalized") {
+                            clearInterval(intervalId);
+                            resolve({
+                                context: result.context,
+                                value: result.value,
+                            });
+                        }
+                    }
+                    else if (tries >= maxTries) {
+                        clearInterval(intervalId);
+                        const timeoutValue = {
+                            err: new Error("Timeout"),
+                        };
+                        resolve({
+                            context: result.context,
+                            value: timeoutValue,
+                        });
+                    }
+                }
+                catch (err) {
+                    clearInterval(intervalId);
+                    reject(err);
+                }
+            })();
+        }, intervalMs);
+    });
+}
+//# sourceMappingURL=magic-router.js.map

package/lib/magic-router.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@magicblock-labs/ephemeral-rollups-sdk",
-  "version": "0.2.5",
+  "version": "0.2.8",
   "author": "MagicBlock Labs",
   "license": "MIT",
   "publishConfig": {
@@ -14,12 +14,15 @@
     "dev": "tsc --watch",
     "start": "tsc",
     "lint": "eslint -c .eslintrc.yml --ext .ts,.tsx src",
-    "lint:fix": "eslint -c .eslintrc.yml --ext .ts,.tsx src --fix"
+    "lint:fix": "eslint -c .eslintrc.yml --ext .ts,.tsx src --fix",
+    "pretest": "tsc",
+    "test": "jest --config ./jest.lib.config.cjs"
   },
   "files": [
     "lib"
   ],
   "devDependencies": {
+    "@types/jest": "^29.5.12",
     "@typescript-eslint/eslint-plugin": "^6.21.0",
     "@typescript-eslint/parser": "^6.21.0",
     "eslint": "^8.55.0",
@@ -29,13 +32,16 @@
     "eslint-plugin-n": "^16.6.2",
     "eslint-plugin-prettier": "^5.2.1",
     "eslint-plugin-promise": "^6.2.0",
+    "jest": "^29.7.0",
     "prettier": "^3.3.2",
     "rimraf": "^3.0.2",
+    "ts-jest": "^29.1.1",
     "typescript": "^5.7.2"
   },
   "dependencies": {
     "@metaplex-foundation/beet": "^0.7.2",
     "@solana/web3.js": "^1.98.0",
+    "bs58": "^6.0.0",
     "rpc-websockets": "^9.0.4"
   },
   "packageManager": "yarn@1.22.22+sha512.a6b2f7906b721bba3d67d4aff083df04dad64c399707841b7acf00f6b133b7ac24255f2652fa22ae3534329dc6180534e98d17432037ff6fd140556e2bb3137e"