tapimo 0.12.0 → 0.14.0

package/dist/internal/funding/providers/stargate.d.ts

@@ -1,19 +1,137 @@
+import { Hex } from 'ox';
+import * as z from 'zod/mini';
+import * as Action from '../Action.js';
+import type * as Catalog from '../Catalog.js';
+import * as Chain from '../Chain.js';
 import * as FundingProvider from '../Provider.js';
-/** Creates a Stargate funding provider backed by LayerZero's `/quotes` endpoint. */
-export declare function stargate(options: stargate.Options): FundingProvider.Provider<"stargate">;
+/** Stargate provider schemas. */
+export declare namespace schema {
+    /** Configuration captured from one selected Stargate route. */
+    const Configuration: z.ZodMiniObject<{
+        destinationPoolAddress: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        poolAddress: z.ZodMiniString<string>;
+        sourceEid: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+    }, z.core.$strict>;
+}
+/** Creates a direct Stargate V2 OFT funding provider. */
+export declare function stargate(options?: stargate.Options): FundingProvider.Provider<"stargate">;
 export declare namespace stargate {
     /** Stargate provider options. */
     type Options = {
-        /** LayerZero Value Transfer API key sent in the required request header. */
-        apiKey: string;
-        /** Override for tests or LayerZero test environments. */
-        baseUrl?: string | undefined;
-        /** Fetch implementation override for tests. */
+        /** Fetch implementation override for chain RPC requests. */
         fetch?: FundingProvider.Fetch | undefined;
         /** Clock override for deterministic tests. */
         now?: (() => Date) | undefined;
-        /** Quote wallet address used as the LayerZero sender and recipient. */
-        userAddress: string;
+    };
+}
+/** Validates one direct Stargate action and returns its exact native-value allowance. */
+export declare function validateAction(options: validateAction.Options): readonly Action.NativeValue[];
+export declare namespace validateAction {
+    /** Expected route terms for one Stargate action. */
+    type Options = {
+        /** Prepared Stargate action. */
+        action: Action.EvmCalls;
+        /** Stargate configuration for the selected route. */
+        configuration?: Catalog.Configuration | undefined;
+        /** Curated Tempo destination token. */
+        destinationTokenAddress: string;
+        /** Tempo beneficiary. */
+        recipient: string;
+        /** Source account and LayerZero refund recipient. */
+        sender: string;
+        /** Exact source amount in base units. */
+        sourceAmount: string;
+        /** Source chain CAIP-2 id. */
+        sourceChainId: string;
+        /** Curated source token. */
+        sourceTokenAddress: string;
+    };
+}
+/** Verifies a submitted Stargate source transaction against stored transfer terms. */
+export declare function verifySourceTransaction(options: verifySourceTransaction.Options): Promise<verifySourceTransaction.Result>;
+export declare namespace verifySourceTransaction {
+    /** Canonical source block that originally contained the transaction. */
+    type Block = {
+        /** Source block hash. */
+        hash: Hex.Hex;
+        /** Source block number. */
+        number: bigint;
+    };
+    /** Stored terms and chain access needed to verify one source transaction. */
+    type Options = {
+        /** Stargate configuration for the selected route. */
+        configuration: unknown;
+        /** Curated Tempo destination token. */
+        destinationTokenAddress: string;
+        /** Fetch implementation override for chain RPC requests. */
+        fetch?: FundingProvider.Fetch | undefined;
+        /** Tempo beneficiary encoded in the Stargate send. */
+        recipient: string;
+        /** Source account and LayerZero refund recipient. */
+        sender: string;
+        /** Optional request cancellation signal. */
+        signal?: AbortSignal | undefined;
+        /** Exact source amount in base units. */
+        sourceAmount: string;
+        /** Canonical block captured during initial verification. */
+        sourceBlock?: Block | undefined;
+        /** Source chain and RPC endpoints. */
+        sourceChain: Chain.Chain;
+        /** Curated source token. */
+        sourceTokenAddress: string;
+        /** Submitted EVM transaction hash. */
+        transactionHash: string;
+        /** Earliest accepted source block timestamp. */
+        validAfter: string;
+    };
+    /** Source transaction verification outcome. */
+    type Result = {
+        type: 'invalid';
+    } | {
+        type: 'pending';
+    } | {
+        type: 'reorged';
+    } | {
+        guid: Hex.Hex;
+        sourceBlock: Block;
+        sourceEid: number;
+        type: 'verified';
+    };
+}
+/** Finds and verifies the finalized Stargate delivery directly on Tempo. */
+export declare function verifyDestinationDelivery(options: verifyDestinationDelivery.Options): Promise<verifyDestinationDelivery.Result>;
+export declare namespace verifyDestinationDelivery {
+    /** Stored terms and chain access needed to discover and verify one delivery. */
+    type Options = {
+        /** Stargate configuration for the selected route. */
+        configuration: unknown;
+        /** Exact destination amount in base units. */
+        destinationAmount: string;
+        /** Tempo block captured before the source transaction was broadcast. */
+        destinationBlockNumber: string;
+        /** Tempo chain and RPC endpoints. */
+        destinationChain: Chain.Chain;
+        /** Curated Tempo destination token. */
+        destinationTokenAddress: string;
+        /** Fetch implementation override for Tempo RPC requests. */
+        fetch?: FundingProvider.Fetch | undefined;
+        /** GUID emitted by the verified source Stargate pool. */
+        guid: Hex.Hex;
+        /** Tempo beneficiary. */
+        recipient: string;
+        /** Source chain CAIP-2 id. */
+        sourceChainId: string;
+        /** Curated source token. */
+        sourceTokenAddress: string;
+    };
+    /** Destination delivery verification outcome. */
+    type Result = {
+        type: 'invalid';
+    } | {
+        type: 'pending';
+    } | {
+        transactionHash: Hex.Hex;
+        type: 'verified';
     };
 }
 //# sourceMappingURL=stargate.d.ts.map

package/dist/internal/funding/providers/stargate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stargate.d.ts","sourceRoot":"","sources":["../../../../src/internal/funding/providers/stargate.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,eAAe,MAAM,gBAAgB,CAAA;AA6CjD,oFAAoF;AACpF,wBAAgB,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,OAAO,wCA+DjD;AAED,MAAM,CAAC,OAAO,WAAW,QAAQ,CAAC;IAChC,iCAAiC;IACjC,KAAK,OAAO,GAAG;QACb,4EAA4E;QAC5E,MAAM,EAAE,MAAM,CAAA;QACd,yDAAyD;QACzD,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QAC5B,+CAA+C;QAC/C,KAAK,CAAC,EAAE,eAAe,CAAC,KAAK,GAAG,SAAS,CAAA;QACzC,8CAA8C;QAC9C,GAAG,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAA;QAC9B,uEAAuE;QACvE,WAAW,EAAE,MAAM,CAAA;KACpB,CAAA;CACF"}
+{"version":3,"file":"stargate.d.ts","sourceRoot":"","sources":["../../../../src/internal/funding/providers/stargate.ts"],"names":[],"mappings":"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"}