@usesigil/kit 0.1.0

package/dist/protocol-resolver.js

@@ -0,0 +1,123 @@
+/**
+ * Protocol Resolver — Kit-native
+ *
+ * Determines protocol tier for allowlist/constraint enforcement:
+ *   KNOWN: Program is in the known protocols registry
+ *   DEFAULT: Passthrough with on-chain constraints
+ *   NOT_ALLOWED: Blocked by policy
+ */
+import * as Core from "./core/index.js";
+// ---------------------------------------------------------------------------
+// Types
+// ---------------------------------------------------------------------------
+export var ProtocolTier;
+(function (ProtocolTier) {
+    ProtocolTier[ProtocolTier["KNOWN"] = 1] = "KNOWN";
+    ProtocolTier[ProtocolTier["DEFAULT"] = 2] = "DEFAULT";
+    ProtocolTier[ProtocolTier["NOT_ALLOWED"] = 3] = "NOT_ALLOWED";
+})(ProtocolTier || (ProtocolTier = {}));
+// ---------------------------------------------------------------------------
+// Core Logic
+// ---------------------------------------------------------------------------
+/**
+ * Check if a program is in the vault's protocol allowlist/denylist.
+ *
+ * @param programId - Program address to check
+ * @param policy - Vault policy with protocolMode and protocols list
+ * @returns true if the program is allowed by the policy
+ */
+export function isProtocolAllowed(programId, policy) {
+    if (policy.protocolMode === 0)
+        return true; // mode 0: all allowed
+    const isInList = policy.protocols.some((p) => p === programId);
+    if (policy.protocolMode === 1)
+        return isInList; // allowlist
+    return !isInList; // denylist
+}
+/**
+ * Resolve the tier and escalation info for a given protocol.
+ *
+ * Resolution logic:
+ * 1. Known program + in allowlist -> KNOWN
+ * 2. Known program + NOT in allowlist -> NOT_ALLOWED
+ * 3. Unknown program + in allowlist + constraints -> DEFAULT (passthrough)
+ * 4. Unknown program + in allowlist + NO constraints -> NOT_ALLOWED (escalation)
+ * 5. Unknown program + NOT in allowlist -> NOT_ALLOWED (escalation)
+ */
+export function resolveProtocol(programId, policy, constraintsConfigured) {
+    const allowed = isProtocolAllowed(programId, policy);
+    const knownName = Core.KNOWN_PROTOCOLS.get(programId);
+    if (knownName) {
+        if (!allowed) {
+            // Path 2: Known but not in allowlist
+            return {
+                tier: ProtocolTier.NOT_ALLOWED,
+                protocolId: programId,
+                programId,
+                displayName: knownName,
+                reason: `${knownName} is not in the vault's protocol allowlist`,
+                escalation: {
+                    type: "not_in_allowlist",
+                    message: `${knownName} (${programId}) is not in your vault's protocol allowlist.`,
+                    requiredActions: [
+                        `Add program ${programId} to the vault's protocol allowlist`,
+                    ],
+                },
+            };
+        }
+        // Path 1: Known + allowed
+        return {
+            tier: ProtocolTier.KNOWN,
+            protocolId: programId,
+            programId,
+            displayName: knownName,
+            reason: `${knownName} is a known protocol`,
+        };
+    }
+    // Unknown protocol
+    if (allowed && constraintsConfigured) {
+        // Path 3: Unknown + allowed + constraints -> passthrough
+        return {
+            tier: ProtocolTier.DEFAULT,
+            protocolId: programId,
+            programId,
+            displayName: programId,
+            reason: "Unknown protocol — using on-chain constraint validation (passthrough)",
+            constraintsConfigured: true,
+        };
+    }
+    if (allowed && !constraintsConfigured) {
+        // Path 4: Unknown + allowed + no constraints
+        return {
+            tier: ProtocolTier.NOT_ALLOWED,
+            protocolId: programId,
+            programId,
+            displayName: programId,
+            reason: "Protocol is allowed but no constraints are configured for validation",
+            escalation: {
+                type: "no_handler_no_constraints",
+                message: `Program ${programId} is in the allowlist but has no on-chain instruction constraints configured.`,
+                requiredActions: [
+                    `Configure instruction constraints for program ${programId} using createConstraints`,
+                ],
+            },
+        };
+    }
+    // Path 5: Unknown + not in allowlist
+    return {
+        tier: ProtocolTier.NOT_ALLOWED,
+        protocolId: programId,
+        programId,
+        displayName: programId,
+        reason: "Protocol is not in the vault's allowlist",
+        escalation: {
+            type: "not_in_allowlist_and_no_handler",
+            message: `Program ${programId} is not in the vault's protocol allowlist.`,
+            requiredActions: [
+                `Add program ${programId} to the vault's protocol allowlist`,
+                `Configure instruction constraints for program ${programId}`,
+            ],
+        },
+    };
+}
+//# sourceMappingURL=protocol-resolver.js.map

package/dist/protocol-resolver.js.map

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

package/dist/resolve-accounts.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Kit-native PDA resolution for Sigil accounts.
+ *
+ * Uses Kit's `getProgramDerivedAddress()` and `getAddressEncoder()` for
+ * seed encoding. All 9 PDA types are derivable.
+ */
+import type { Address } from "@solana/kit";
+export declare function getVaultPDA(owner: Address, vaultId: bigint, programAddress?: Address): Promise<[Address, number]>;
+export declare function getPolicyPDA(vault: Address, programAddress?: Address): Promise<[Address, number]>;
+export declare function getTrackerPDA(vault: Address, programAddress?: Address): Promise<[Address, number]>;
+export declare function getSessionPDA(vault: Address, agent: Address, tokenMint: Address, programAddress?: Address): Promise<[Address, number]>;
+export declare function getPendingPolicyPDA(vault: Address, programAddress?: Address): Promise<[Address, number]>;
+export declare function getEscrowPDA(sourceVault: Address, destinationVault: Address, escrowId: bigint, programAddress?: Address): Promise<[Address, number]>;
+export declare function getAgentOverlayPDA(vault: Address, shardIndex?: number, programAddress?: Address): Promise<[Address, number]>;
+export declare function getConstraintsPDA(vault: Address, programAddress?: Address): Promise<[Address, number]>;
+export declare function getPendingConstraintsPDA(vault: Address, programAddress?: Address): Promise<[Address, number]>;
+export interface ResolveAccountsInput {
+    vault: Address;
+    agent: Address;
+    tokenMint: Address;
+    outputMint?: Address;
+    feeDestination?: Address;
+    hasConstraints?: boolean;
+}
+export interface ResolvedAccounts {
+    vault: Address;
+    policyPda: Address;
+    trackerPda: Address;
+    sessionPda: Address;
+    constraintsPda?: Address;
+    agentOverlayPda?: Address;
+}
+/**
+ * Auto-derive all PDA accounts needed for a composed Sigil transaction.
+ * Token ATAs must be derived separately using `@solana-program/token`.
+ */
+export declare function resolveAccounts(input: ResolveAccountsInput, programAddress?: Address): Promise<ResolvedAccounts>;
+//# sourceMappingURL=resolve-accounts.d.ts.map

package/dist/resolve-accounts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-accounts.d.ts","sourceRoot":"","sources":["../src/resolve-accounts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAsB,MAAM,aAAa,CAAC;AA8B/D,wBAAsB,WAAW,CAC/B,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,MAAM,EACf,cAAc,GAAE,OAA+B,GAC9C,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAM5B;AAED,wBAAsB,YAAY,CAChC,KAAK,EAAE,OAAO,EACd,cAAc,GAAE,OAA+B,GAC9C,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAM5B;AAED,wBAAsB,aAAa,CACjC,KAAK,EAAE,OAAO,EACd,cAAc,GAAE,OAA+B,GAC9C,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAM5B;AAED,wBAAsB,aAAa,CACjC,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,OAAO,EAClB,cAAc,GAAE,OAA+B,GAC9C,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAW5B;AAED,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,OAAO,EACd,cAAc,GAAE,OAA+B,GAC9C,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAM5B;AAED,wBAAsB,YAAY,CAChC,WAAW,EAAE,OAAO,EACpB,gBAAgB,EAAE,OAAO,EACzB,QAAQ,EAAE,MAAM,EAChB,cAAc,GAAE,OAA+B,GAC9C,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAW5B;AAED,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,OAAO,EACd,UAAU,GAAE,MAAU,EACtB,cAAc,GAAE,OAA+B,GAC9C,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAM5B;AAED,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,OAAO,EACd,cAAc,GAAE,OAA+B,GAC9C,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAM5B;AAED,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,OAAO,EACd,cAAc,GAAE,OAA+B,GAC9C,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAM5B;AAID,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,oBAAoB,EAC3B,cAAc,GAAE,OAA+B,GAC9C,OAAO,CAAC,gBAAgB,CAAC,CA0B3B"}

package/dist/resolve-accounts.js

@@ -0,0 +1,120 @@
+/**
+ * Kit-native PDA resolution for Sigil accounts.
+ *
+ * Uses Kit's `getProgramDerivedAddress()` and `getAddressEncoder()` for
+ * seed encoding. All 9 PDA types are derivable.
+ */
+import { getAddressEncoder, getProgramDerivedAddress } from "@solana/kit";
+import { SIGIL_PROGRAM_ADDRESS } from "./generated/programs/sigil.js";
+// ─── PDA Derivation ──────────────────────────────────────────────────────────
+const encoder = getAddressEncoder();
+const textEncoder = new TextEncoder();
+function seedString(s) {
+    return textEncoder.encode(s);
+}
+function seedAddress(addr) {
+    return encoder.encode(addr);
+}
+function seedU64Le(value) {
+    const buf = new Uint8Array(8);
+    const view = new DataView(buf.buffer);
+    view.setBigUint64(0, value, true); // little-endian
+    return buf;
+}
+function seedU8(value) {
+    return new Uint8Array([value]);
+}
+export async function getVaultPDA(owner, vaultId, programAddress = SIGIL_PROGRAM_ADDRESS) {
+    const [pda, bump] = await getProgramDerivedAddress({
+        programAddress,
+        seeds: [seedString("vault"), seedAddress(owner), seedU64Le(vaultId)],
+    });
+    return [pda, bump];
+}
+export async function getPolicyPDA(vault, programAddress = SIGIL_PROGRAM_ADDRESS) {
+    const [pda, bump] = await getProgramDerivedAddress({
+        programAddress,
+        seeds: [seedString("policy"), seedAddress(vault)],
+    });
+    return [pda, bump];
+}
+export async function getTrackerPDA(vault, programAddress = SIGIL_PROGRAM_ADDRESS) {
+    const [pda, bump] = await getProgramDerivedAddress({
+        programAddress,
+        seeds: [seedString("tracker"), seedAddress(vault)],
+    });
+    return [pda, bump];
+}
+export async function getSessionPDA(vault, agent, tokenMint, programAddress = SIGIL_PROGRAM_ADDRESS) {
+    const [pda, bump] = await getProgramDerivedAddress({
+        programAddress,
+        seeds: [
+            seedString("session"),
+            seedAddress(vault),
+            seedAddress(agent),
+            seedAddress(tokenMint),
+        ],
+    });
+    return [pda, bump];
+}
+export async function getPendingPolicyPDA(vault, programAddress = SIGIL_PROGRAM_ADDRESS) {
+    const [pda, bump] = await getProgramDerivedAddress({
+        programAddress,
+        seeds: [seedString("pending_policy"), seedAddress(vault)],
+    });
+    return [pda, bump];
+}
+export async function getEscrowPDA(sourceVault, destinationVault, escrowId, programAddress = SIGIL_PROGRAM_ADDRESS) {
+    const [pda, bump] = await getProgramDerivedAddress({
+        programAddress,
+        seeds: [
+            seedString("escrow"),
+            seedAddress(sourceVault),
+            seedAddress(destinationVault),
+            seedU64Le(escrowId),
+        ],
+    });
+    return [pda, bump];
+}
+export async function getAgentOverlayPDA(vault, shardIndex = 0, programAddress = SIGIL_PROGRAM_ADDRESS) {
+    const [pda, bump] = await getProgramDerivedAddress({
+        programAddress,
+        seeds: [seedString("agent_spend"), seedAddress(vault), seedU8(shardIndex)],
+    });
+    return [pda, bump];
+}
+export async function getConstraintsPDA(vault, programAddress = SIGIL_PROGRAM_ADDRESS) {
+    const [pda, bump] = await getProgramDerivedAddress({
+        programAddress,
+        seeds: [seedString("constraints"), seedAddress(vault)],
+    });
+    return [pda, bump];
+}
+export async function getPendingConstraintsPDA(vault, programAddress = SIGIL_PROGRAM_ADDRESS) {
+    const [pda, bump] = await getProgramDerivedAddress({
+        programAddress,
+        seeds: [seedString("pending_constraints"), seedAddress(vault)],
+    });
+    return [pda, bump];
+}
+/**
+ * Auto-derive all PDA accounts needed for a composed Sigil transaction.
+ * Token ATAs must be derived separately using `@solana-program/token`.
+ */
+export async function resolveAccounts(input, programAddress = SIGIL_PROGRAM_ADDRESS) {
+    const [policyPda] = await getPolicyPDA(input.vault, programAddress);
+    const [trackerPda] = await getTrackerPDA(input.vault, programAddress);
+    const [sessionPda] = await getSessionPDA(input.vault, input.agent, input.tokenMint, programAddress);
+    const result = {
+        vault: input.vault,
+        policyPda,
+        trackerPda,
+        sessionPda,
+    };
+    if (input.hasConstraints) {
+        const [constraintsPda] = await getConstraintsPDA(input.vault, programAddress);
+        result.constraintsPda = constraintsPda;
+    }
+    return result;
+}
+//# sourceMappingURL=resolve-accounts.js.map

package/dist/resolve-accounts.js.map

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

package/dist/rpc-helpers.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Kit-native RPC helpers for Sigil SDK.
+ *
+ * - BlockhashCache: Caches getLatestBlockhash with configurable TTL
+ * - signAndEncode: Sign a compiled TX + encode to base64 wire format
+ * - sendAndConfirmTransaction: Send + poll getSignatureStatuses
+ */
+import type { Rpc, SolanaRpcApi, Commitment, Base64EncodedWireTransaction, TransactionSigner } from "@solana/kit";
+export interface Blockhash {
+    blockhash: string;
+    lastValidBlockHeight: bigint;
+}
+export interface SendAndConfirmOptions {
+    /** Max time to wait for confirmation (ms). Default: 30_000 */
+    timeoutMs?: number;
+    /** Poll interval (ms). Default: 1_000 */
+    pollIntervalMs?: number;
+    /** Confirmation commitment. Default: "confirmed" */
+    commitment?: Commitment;
+}
+export declare class BlockhashCache {
+    private cached;
+    private fetchedAt;
+    private readonly ttlMs;
+    constructor(ttlMs?: number);
+    /**
+     * Get a blockhash, returning cached value if still within TTL.
+     */
+    get(rpc: Rpc<SolanaRpcApi>): Promise<Blockhash>;
+    /**
+     * Force a fresh blockhash fetch regardless of TTL.
+     */
+    invalidate(): void;
+    private refresh;
+}
+/**
+ * Sign a compiled transaction and encode to base64 wire format.
+ *
+ * Handles Kit's TransactionSigner interface which may expose
+ * `modifyAndSignTransactions` or `signTransactions` (both accept/return arrays).
+ *
+ * @returns Base64-encoded wire transaction ready for sendTransaction RPC.
+ */
+export declare function signAndEncode(signer: TransactionSigner, compiledTx: unknown): Promise<Base64EncodedWireTransaction>;
+/**
+ * Send a base64-encoded transaction and poll for confirmation.
+ * Throws on timeout or confirmed failure.
+ */
+export declare function sendAndConfirmTransaction(rpc: Rpc<SolanaRpcApi>, encodedTransaction: Base64EncodedWireTransaction, options?: SendAndConfirmOptions): Promise<string>;
+//# sourceMappingURL=rpc-helpers.d.ts.map

package/dist/rpc-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc-helpers.d.ts","sourceRoot":"","sources":["../src/rpc-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,YAAY,EAAE,UAAU,EAAE,4BAA4B,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAWlH,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,qBAAqB;IACpC,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oDAAoD;IACpD,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAMD,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAEnB,KAAK,CAAC,EAAE,MAAM;IAI1B;;OAEG;IACG,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC;IAQrD;;OAEG;IACH,UAAU,IAAI,IAAI;YAKJ,OAAO;CAgBtB;AAID;;;;;;;GAOG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,iBAAiB,EACzB,UAAU,EAAE,OAAO,GAClB,OAAO,CAAC,4BAA4B,CAAC,CAmBvC;AAID;;;GAGG;AACH,wBAAsB,yBAAyB,CAC7C,GAAG,EAAE,GAAG,CAAC,YAAY,CAAC,EACtB,kBAAkB,EAAE,4BAA4B,EAChD,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,MAAM,CAAC,CAwDjB"}

package/dist/rpc-helpers.js

@@ -0,0 +1,119 @@
+/**
+ * Kit-native RPC helpers for Sigil SDK.
+ *
+ * - BlockhashCache: Caches getLatestBlockhash with configurable TTL
+ * - signAndEncode: Sign a compiled TX + encode to base64 wire format
+ * - sendAndConfirmTransaction: Send + poll getSignatureStatuses
+ */
+import { getBase64EncodedWireTransaction } from "@solana/kit";
+// ─── BlockhashCache ─────────────────────────────────────────────────────────
+const DEFAULT_BLOCKHASH_TTL_MS = 30_000;
+export class BlockhashCache {
+    cached = null;
+    fetchedAt = 0;
+    ttlMs;
+    constructor(ttlMs) {
+        this.ttlMs = ttlMs ?? DEFAULT_BLOCKHASH_TTL_MS;
+    }
+    /**
+     * Get a blockhash, returning cached value if still within TTL.
+     */
+    async get(rpc) {
+        const now = Date.now();
+        if (this.cached && now - this.fetchedAt < this.ttlMs) {
+            return this.cached;
+        }
+        return this.refresh(rpc);
+    }
+    /**
+     * Force a fresh blockhash fetch regardless of TTL.
+     */
+    invalidate() {
+        this.cached = null;
+        this.fetchedAt = 0;
+    }
+    async refresh(rpc) {
+        const result = await rpc
+            .getLatestBlockhash({ commitment: "confirmed" })
+            .send();
+        const value = result.value;
+        this.cached = {
+            blockhash: value.blockhash,
+            lastValidBlockHeight: value.lastValidBlockHeight,
+        };
+        this.fetchedAt = Date.now();
+        return this.cached;
+    }
+}
+// ─── signAndEncode ───────────────────────────────────────────────────────────
+/**
+ * Sign a compiled transaction and encode to base64 wire format.
+ *
+ * Handles Kit's TransactionSigner interface which may expose
+ * `modifyAndSignTransactions` or `signTransactions` (both accept/return arrays).
+ *
+ * @returns Base64-encoded wire transaction ready for sendTransaction RPC.
+ */
+export async function signAndEncode(signer, compiledTx) {
+    const signerTyped = signer;
+    const signFn = signerTyped.modifyAndSignTransactions ?? signerTyped.signTransactions;
+    if (typeof signFn !== "function") {
+        throw new Error("Signer must implement signTransactions() or modifyAndSignTransactions()");
+    }
+    const results = await signFn.call(signerTyped, [compiledTx]);
+    if (!Array.isArray(results) || results.length === 0) {
+        throw new Error("signTransactions returned invalid result: expected non-empty array");
+    }
+    const [signedTx] = results;
+    return getBase64EncodedWireTransaction(signedTx);
+}
+// ─── sendAndConfirmTransaction ──────────────────────────────────────────────
+/**
+ * Send a base64-encoded transaction and poll for confirmation.
+ * Throws on timeout or confirmed failure.
+ */
+export async function sendAndConfirmTransaction(rpc, encodedTransaction, options) {
+    const timeoutMs = options?.timeoutMs ?? 30_000;
+    const pollIntervalMs = options?.pollIntervalMs ?? 1_000;
+    const commitment = options?.commitment ?? "confirmed";
+    // Send the transaction
+    const signature = await rpc
+        .sendTransaction(encodedTransaction, {
+        encoding: "base64",
+        skipPreflight: false,
+        preflightCommitment: commitment,
+    })
+        .send();
+    // Poll for confirmation
+    const deadline = Date.now() + timeoutMs;
+    let delay = pollIntervalMs;
+    while (Date.now() < deadline) {
+        const statusResult = await rpc
+            .getSignatureStatuses([signature])
+            .send();
+        const statuses = statusResult.value;
+        if (statuses && statuses[0]) {
+            const status = statuses[0];
+            // Check for error
+            if (status.err) {
+                throw new Error(`Transaction ${signature} failed: ${JSON.stringify(status.err)}`);
+            }
+            // Check for sufficient confirmation
+            const level = status.confirmationStatus;
+            if (level === "confirmed" ||
+                level === "finalized" ||
+                (commitment === "processed" && level === "processed")) {
+                return signature;
+            }
+        }
+        // Exponential backoff: 1s → 1.5s → 2.25s → ...
+        await sleep(delay);
+        delay = Math.min(delay * (1.3 + Math.random() * 0.4), 5_000);
+    }
+    throw new Error(`Transaction ${signature} confirmation timed out after ${timeoutMs}ms`);
+}
+// ─── Helpers ────────────────────────────────────────────────────────────────
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=rpc-helpers.js.map

package/dist/rpc-helpers.js.map

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