@recoillink/sdk 0.0.0-stage → 45.0.1

package/dist/quote/Eip712Signable.js

@@ -0,0 +1,27 @@
+import { assert } from '@recoillink/utils';
+function isEip712TypedDataDomain(x) {
+    if (typeof x !== 'object' || x === null)
+        return false;
+    const d = x;
+    return (typeof d.name === 'string' &&
+        typeof d.version === 'string' &&
+        typeof d.chainId === 'number' &&
+        typeof d.verifyingContract === 'string');
+}
+export function isEip712Signable(input) {
+    if (typeof input !== 'object' || input === null)
+        return false;
+    const o = input;
+    if (typeof o.types !== 'object' || o.types === null)
+        return false;
+    if (typeof o.message !== 'object' || o.message === null)
+        return false;
+    if (!isEip712TypedDataDomain(o.domain))
+        return false;
+    return true;
+}
+export function parseEip712Signable(input) {
+    assert(isEip712Signable(input), 'Expected EIP-712 signable envelope: { domain, types, message }.');
+    return input;
+}
+//# sourceMappingURL=Eip712Signable.js.map

package/dist/quote/Eip712Signable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Eip712Signable.js","sourceRoot":"","sources":["../../src/quote/Eip712Signable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AA4B3C,SAAS,uBAAuB,CAAC,CAAU;IACzC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,CAAC,GAAG,CAA4B,CAAC;IACvC,OAAO,CACL,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ;QAC1B,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ;QAC7B,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ;QAC7B,OAAO,CAAC,CAAC,iBAAiB,KAAK,QAAQ,CACxC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,CAAC,GAAG,KAAgC,CAAC;IAC3C,IAAI,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,CAAC,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAClE,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,CAAC,OAAO,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IACtE,IAAI,CAAC,uBAAuB,CAAC,CAAC,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IACrD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,MAAM,CACJ,gBAAgB,CAAC,KAAK,CAAC,EACvB,iEAAiE,CAClE,CAAC;IACF,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/quote/EvmPrivateKeyQuoteSigner.d.ts

@@ -0,0 +1,15 @@
+import { QuoteSignature, RawQuoteSigner, SignableInput } from '@recoillink/provider-sdk/quote';
+/**
+ * Default `RawQuoteSigner` implementation for EVM. Wraps an ethers `Wallet`
+ * and narrows the opaque `SignableInput` envelope to an EIP-712 typed-data
+ * payload via `parseEip712Signable`. Throws when the input is not an EIP-712
+ * envelope — the SVM digest-style signer is a parallel implementation, not a
+ * fallback path here.
+ */
+export declare class EvmPrivateKeyQuoteSigner implements RawQuoteSigner {
+    private readonly wallet;
+    constructor(privateKey: string);
+    address(): Promise<string>;
+    sign(input: SignableInput): Promise<QuoteSignature>;
+}
+//# sourceMappingURL=EvmPrivateKeyQuoteSigner.d.ts.map

package/dist/quote/EvmPrivateKeyQuoteSigner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EvmPrivateKeyQuoteSigner.d.ts","sourceRoot":"","sources":["../../src/quote/EvmPrivateKeyQuoteSigner.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,cAAc,EACd,cAAc,EACd,aAAa,EACd,MAAM,gCAAgC,CAAC;AAIxC;;;;;;GAMG;AACH,qBAAa,wBAAyB,YAAW,cAAc;IAC7D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAEhC,YAAY,UAAU,EAAE,MAAM,EAE7B;IAEK,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,CAE/B;IAEK,IAAI,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CAQxD;CACF"}

package/dist/quote/EvmPrivateKeyQuoteSigner.js

@@ -0,0 +1,24 @@
+import { Wallet, utils as ethersUtils } from 'ethers';
+import { parseEip712Signable } from './Eip712Signable.js';
+/**
+ * Default `RawQuoteSigner` implementation for EVM. Wraps an ethers `Wallet`
+ * and narrows the opaque `SignableInput` envelope to an EIP-712 typed-data
+ * payload via `parseEip712Signable`. Throws when the input is not an EIP-712
+ * envelope — the SVM digest-style signer is a parallel implementation, not a
+ * fallback path here.
+ */
+export class EvmPrivateKeyQuoteSigner {
+    wallet;
+    constructor(privateKey) {
+        this.wallet = new Wallet(privateKey);
+    }
+    async address() {
+        return this.wallet.address;
+    }
+    async sign(input) {
+        const signable = parseEip712Signable(input);
+        const sig = await this.wallet._signTypedData(signable.domain, signable.types, signable.message);
+        return { signature: ethersUtils.arrayify(sig) };
+    }
+}
+//# sourceMappingURL=EvmPrivateKeyQuoteSigner.js.map

package/dist/quote/EvmPrivateKeyQuoteSigner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EvmPrivateKeyQuoteSigner.js","sourceRoot":"","sources":["../../src/quote/EvmPrivateKeyQuoteSigner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,IAAI,WAAW,EAAE,MAAM,QAAQ,CAAC;AAQtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE1D;;;;;;GAMG;AACH,MAAM,OAAO,wBAAwB;IAClB,MAAM,CAAS;IAEhC,YAAY,UAAkB;QAC5B,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CAAC,UAAU,CAAC,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,OAAO;QACX,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAAoB;QAC7B,MAAM,QAAQ,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;QAC5C,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,cAAc,CAC1C,QAAQ,CAAC,MAAM,EACf,QAAQ,CAAC,KAAK,EACd,QAAQ,CAAC,OAAO,CACjB,CAAC;QACF,OAAO,EAAE,SAAS,EAAE,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;IAClD,CAAC;CACF"}

package/dist/quote/EvmPrivateKeyQuoteSigner.test.d.ts

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

package/dist/quote/EvmPrivateKeyQuoteSigner.test.d.ts.map

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

package/dist/quote/EvmPrivateKeyQuoteSigner.test.js

@@ -0,0 +1,23 @@
+import { expect } from 'chai';
+import { EvmPrivateKeyQuoteSigner } from './EvmPrivateKeyQuoteSigner.js';
+// Anvil test account #1 — public test key, no live funds.
+const FIXED_PK = '0x59c6995e998f97a5a0044966f0945389dc9e86dae88c7a8412f4603b6b78690d';
+const EXPECTED_ADDRESS = '0x70997970C51812dc3A010C7d01b50e0d17dc79C8';
+describe('EvmPrivateKeyQuoteSigner', () => {
+    it('exposes the wallet address', async () => {
+        const signer = new EvmPrivateKeyQuoteSigner(FIXED_PK);
+        expect(await signer.address()).to.equal(EXPECTED_ADDRESS);
+    });
+    it('throws when the input is not an EIP-712 envelope', async () => {
+        const signer = new EvmPrivateKeyQuoteSigner(FIXED_PK);
+        let threw = false;
+        try {
+            await signer.sign({ not: 'a signable' });
+        }
+        catch {
+            threw = true;
+        }
+        expect(threw).to.equal(true);
+    });
+});
+//# sourceMappingURL=EvmPrivateKeyQuoteSigner.test.js.map

package/dist/quote/EvmPrivateKeyQuoteSigner.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EvmPrivateKeyQuoteSigner.test.js","sourceRoot":"","sources":["../../src/quote/EvmPrivateKeyQuoteSigner.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAE9B,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAEzE,0DAA0D;AAC1D,MAAM,QAAQ,GACZ,oEAAoE,CAAC;AACvE,MAAM,gBAAgB,GAAG,4CAA4C,CAAC;AAEtE,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;IACxC,EAAE,CAAC,4BAA4B,EAAE,KAAK,IAAI,EAAE;QAC1C,MAAM,MAAM,GAAG,IAAI,wBAAwB,CAAC,QAAQ,CAAC,CAAC;QACtD,MAAM,CAAC,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,KAAK,IAAI,EAAE;QAChE,MAAM,MAAM,GAAG,IAAI,wBAAwB,CAAC,QAAQ,CAAC,CAAC;QACtD,IAAI,KAAK,GAAG,KAAK,CAAC;QAClB,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,YAAY,EAAE,CAAC,CAAC;QAC3C,CAAC;QAAC,MAAM,CAAC;YACP,KAAK,GAAG,IAAI,CAAC;QACf,CAAC;QACD,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/quote/EvmQuoteArtifactManager.d.ts

@@ -0,0 +1,20 @@
+import { type FeeReadContext } from '@recoillink/provider-sdk/fee';
+import { type IRawWarpQuoteArtifactManager, type IRawWarpQuoteReader, type IRawWarpQuoteWriter, type RawQuoteSigner } from '@recoillink/provider-sdk/quote';
+import { type MultiProvider } from '../providers/MultiProvider.js';
+/**
+ * EVM implementation of `IRawWarpQuoteArtifactManager`. The constructor only
+ * carries the read-side dependency (`multiProvider`) so read-only callers
+ * (`warp quote read`) don't need a tx signer. `createWriter` accepts the
+ * `ethers.Signer` as a method parameter, matching the alt-VM artifact
+ * manager convention.
+ */
+export declare class EvmQuoteArtifactManager implements IRawWarpQuoteArtifactManager {
+    private readonly multiProvider;
+    private readonly chainName;
+    private readonly feeAddress;
+    private readonly context;
+    constructor(multiProvider: MultiProvider, chainName: string, feeAddress: string, context: FeeReadContext);
+    createWriter(quoteSigner: RawQuoteSigner, txSigner: unknown): IRawWarpQuoteWriter;
+    createReader(): IRawWarpQuoteReader;
+}
+//# sourceMappingURL=EvmQuoteArtifactManager.d.ts.map

package/dist/quote/EvmQuoteArtifactManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EvmQuoteArtifactManager.d.ts","sourceRoot":"","sources":["../../src/quote/EvmQuoteArtifactManager.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EACL,KAAK,4BAA4B,EACjC,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACpB,MAAM,gCAAgC,CAAC;AAGxC,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAKnE;;;;;;GAMG;AACH,qBAAa,uBAAwB,YAAW,4BAA4B;IAExE,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJ1B,YACmB,aAAa,EAAE,aAAa,EAC5B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,cAAc,EACtC;IAEJ,YAAY,CACV,WAAW,EAAE,cAAc,EAC3B,QAAQ,EAAE,OAAO,GAChB,mBAAmB,CAMrB;IAED,YAAY,IAAI,mBAAmB,CAGlC;CACF"}

package/dist/quote/EvmQuoteArtifactManager.js

@@ -0,0 +1,32 @@
+import { ethers } from 'ethers';
+import { assert } from '@recoillink/utils';
+import { EvmQuoteReader } from './EvmQuoteReader.js';
+import { EvmQuoteWriter } from './EvmQuoteWriter.js';
+/**
+ * EVM implementation of `IRawWarpQuoteArtifactManager`. The constructor only
+ * carries the read-side dependency (`multiProvider`) so read-only callers
+ * (`warp quote read`) don't need a tx signer. `createWriter` accepts the
+ * `ethers.Signer` as a method parameter, matching the alt-VM artifact
+ * manager convention.
+ */
+export class EvmQuoteArtifactManager {
+    multiProvider;
+    chainName;
+    feeAddress;
+    context;
+    constructor(multiProvider, chainName, feeAddress, context) {
+        this.multiProvider = multiProvider;
+        this.chainName = chainName;
+        this.feeAddress = feeAddress;
+        this.context = context;
+    }
+    createWriter(quoteSigner, txSigner) {
+        assert(txSigner instanceof ethers.Signer, 'EvmQuoteArtifactManager.createWriter requires an ethers.Signer');
+        return new EvmQuoteWriter(txSigner, quoteSigner, this.feeAddress);
+    }
+    createReader() {
+        const provider = this.multiProvider.getProvider(this.chainName);
+        return new EvmQuoteReader(provider, this.feeAddress, this.context);
+    }
+}
+//# sourceMappingURL=EvmQuoteArtifactManager.js.map

package/dist/quote/EvmQuoteArtifactManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EvmQuoteArtifactManager.js","sourceRoot":"","sources":["../../src/quote/EvmQuoteArtifactManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAShC,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAI3C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD;;;;;;GAMG;AACH,MAAM,OAAO,uBAAuB;IAEf,aAAa;IACb,SAAS;IACT,UAAU;IACV,OAAO;IAJ1B,YACmB,aAA4B,EAC5B,SAAiB,EACjB,UAAkB,EAClB,OAAuB;6BAHvB,aAAa;yBACb,SAAS;0BACT,UAAU;uBACV,OAAO;IACvB,CAAC;IAEJ,YAAY,CACV,WAA2B,EAC3B,QAAiB;QAEjB,MAAM,CACJ,QAAQ,YAAY,MAAM,CAAC,MAAM,EACjC,gEAAgE,CACjE,CAAC;QACF,OAAO,IAAI,cAAc,CAAC,QAAQ,EAAE,WAAW,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IACpE,CAAC;IAED,YAAY;QACV,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAChE,OAAO,IAAI,cAAc,CAAC,QAAQ,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACrE,CAAC;CACF"}

package/dist/quote/EvmQuoteReader.d.ts

@@ -0,0 +1,24 @@
+import { providers as ethersProviders } from 'ethers';
+import { type FeeReadContext } from '@recoillink/provider-sdk/fee';
+import { type IRawWarpQuoteReader, type ReadStandingQuotesOpts, type StandingWarpQuoteEntry, type WarpQuoteScope } from '@recoillink/provider-sdk/quote';
+/**
+ * Reads standing offchain-quote entries from a deployed `OffchainQuotedLinearFee`.
+ * The contract stores standing quotes in a non-enumerable `quotes(dest, recipient)`
+ * mapping keyed by `(uint32 destination, bytes32 recipient)`, so the reader
+ * enumerates the `(dest, recipient)` candidates the cross-VM helper produces and
+ * queries each — dropping `expiry == 0` (unset slots).
+ *
+ * EVM has no on-chain `targetRouter` dimension; returned entries set
+ * `targetRouter = WARP_TARGET_ROUTER_NONE`. When this leaf sits under a
+ * CrossCollateralRoutingFee, callers that need to distinguish sibling-leaf
+ * entries label them at a higher layer using the deploy-config router key.
+ */
+export declare class EvmQuoteReader implements IRawWarpQuoteReader {
+    private readonly provider;
+    private readonly feeAddress;
+    private readonly context;
+    constructor(provider: ethersProviders.Provider, feeAddress: string, context: FeeReadContext);
+    enumerateCandidates(): Promise<WarpQuoteScope[]>;
+    readStandingQuotes(opts?: ReadStandingQuotesOpts): Promise<StandingWarpQuoteEntry[]>;
+}
+//# sourceMappingURL=EvmQuoteReader.d.ts.map

package/dist/quote/EvmQuoteReader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EvmQuoteReader.d.ts","sourceRoot":"","sources":["../../src/quote/EvmQuoteReader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,IAAI,eAAe,EAAE,MAAM,QAAQ,CAAC;AAGtD,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAI3B,KAAK,cAAc,EAEpB,MAAM,gCAAgC,CAAC;AAExC;;;;;;;;;;;GAWG;AACH,qBAAa,cAAe,YAAW,mBAAmB;IAEtD,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAH1B,YACmB,QAAQ,EAAE,eAAe,CAAC,QAAQ,EAClC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,cAAc,EACtC;IAEE,mBAAmB,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAIrD;IAEK,kBAAkB,CACtB,IAAI,CAAC,EAAE,sBAAsB,GAC5B,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAiEnC;CACF"}

package/dist/quote/EvmQuoteReader.hardhat-test.d.ts

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

package/dist/quote/EvmQuoteReader.hardhat-test.d.ts.map

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

package/dist/quote/EvmQuoteReader.hardhat-test.js

@@ -0,0 +1,157 @@
+import { expect } from 'chai';
+import { Wallet } from 'ethers';
+import hre from 'hardhat';
+import { ERC20Test__factory, OffchainQuotedLinearFee__factory, } from '@recoillink/core';
+import { WARP_QUOTE_AMOUNT_WILDCARD, WARP_TARGET_ROUTER_NONE, WILDCARD_BYTES32, } from '@recoillink/provider-sdk/quote';
+import { assert } from '@recoillink/utils';
+import { TestChainName } from '../consts/testChains.js';
+import { MultiProvider } from '../providers/MultiProvider.js';
+import { EvmPrivateKeyQuoteSigner } from './EvmPrivateKeyQuoteSigner.js';
+import { EvmQuoteArtifactManager } from './EvmQuoteArtifactManager.js';
+const TEST_MNEMONIC = 'test test test test test test test test test test test junk';
+const MAX_FEE = 1000n;
+const HALF_AMOUNT = 1000000n;
+const DEST_DOMAIN = 137;
+const ROUTER = '0x' + 'aa'.repeat(32);
+describe('EvmQuoteReader (hardhat)', () => {
+    const chain = TestChainName.test1;
+    let owner;
+    let multiProvider;
+    let token;
+    let fee;
+    let quoteSignerWallet;
+    before(async () => {
+        [owner] = await hre.ethers.getSigners();
+        multiProvider = MultiProvider.createTestMultiProvider({ signer: owner });
+        const erc20 = new ERC20Test__factory(owner);
+        token = await erc20.deploy('fake', 'FAKE', '100000000000000000000', 18);
+        await token.deployed();
+        quoteSignerWallet = Wallet.fromMnemonic(TEST_MNEMONIC, "m/44'/60'/0'/0/1");
+        const offchain = new OffchainQuotedLinearFee__factory(owner);
+        fee = await offchain.deploy(quoteSignerWallet.address, token.address, MAX_FEE, HALF_AMOUNT, owner.address);
+        await fee.deployed();
+    });
+    function makeManager(context) {
+        return new EvmQuoteArtifactManager(multiProvider, chain, fee.address, context);
+    }
+    // Derive "now" from the chain's latest block rather than wall-clock time so
+    // these tests stay correct when an earlier hardhat suite warps the shared
+    // node's block.timestamp (e.g. the timelock tests) ahead of real time.
+    async function nowSec() {
+        const { timestamp } = await hre.ethers.provider.getBlock('latest');
+        return timestamp;
+    }
+    it('returns no entries before any quote is submitted', async () => {
+        const reader = makeManager({
+            knownRoutersPerDomain: { [DEST_DOMAIN]: new Set([ROUTER]) },
+        }).createReader();
+        expect(await reader.readStandingQuotes()).to.deep.equal([]);
+    });
+    it('reads a standing quote keyed by a specific recipient', async () => {
+        const context = {
+            knownRoutersPerDomain: { [DEST_DOMAIN]: new Set([ROUTER]) },
+        };
+        const writer = makeManager(context).createWriter(new EvmPrivateKeyQuoteSigner(quoteSignerWallet.privateKey), owner);
+        const issuedAt = await nowSec();
+        const expiry = issuedAt + 3600;
+        await writer.submitQuote({
+            scope: {
+                destination: DEST_DOMAIN,
+                recipient: ROUTER,
+                targetRouter: WARP_TARGET_ROUTER_NONE,
+                amount: WARP_QUOTE_AMOUNT_WILDCARD,
+            },
+            params: { maxFee: 4321n, halfAmount: 8765n },
+            issuedAt,
+            expiry,
+        });
+        const entries = await makeManager(context)
+            .createReader()
+            .readStandingQuotes();
+        const match = entries.find((e) => e.scope.recipient === ROUTER);
+        assert(match, 'expected a standing entry for ROUTER recipient');
+        expect(match.scope.destination).to.equal(DEST_DOMAIN);
+        expect(match.params.maxFee).to.equal(4321n);
+        expect(match.params.halfAmount).to.equal(8765n);
+        expect(match.issuedAt).to.equal(issuedAt);
+        expect(match.expiry).to.equal(expiry);
+    });
+    it('reads a standing quote keyed by the wildcard recipient', async () => {
+        const context = {
+            knownRoutersPerDomain: { [DEST_DOMAIN]: new Set([ROUTER]) },
+        };
+        const writer = makeManager(context).createWriter(new EvmPrivateKeyQuoteSigner(quoteSignerWallet.privateKey), owner);
+        const issuedAt = (await nowSec()) + 1;
+        const expiry = issuedAt + 7200;
+        await writer.submitQuote({
+            scope: {
+                destination: DEST_DOMAIN,
+                recipient: WILDCARD_BYTES32,
+                targetRouter: WARP_TARGET_ROUTER_NONE,
+                amount: WARP_QUOTE_AMOUNT_WILDCARD,
+            },
+            params: { maxFee: 11n, halfAmount: 22n },
+            issuedAt,
+            expiry,
+        });
+        const entries = await makeManager(context)
+            .createReader()
+            .readStandingQuotes();
+        const match = entries.find((e) => e.scope.destination === DEST_DOMAIN &&
+            e.scope.recipient === WILDCARD_BYTES32);
+        assert(match, 'expected a standing entry for the wildcard recipient');
+        expect(match.params.maxFee).to.equal(11n);
+        expect(match.params.halfAmount).to.equal(22n);
+        expect(match.issuedAt).to.equal(issuedAt);
+        expect(match.expiry).to.equal(expiry);
+    });
+    it('reads a quote keyed by a non-router recipient when passed via extraRecipients', async () => {
+        const context = {
+            knownRoutersPerDomain: { [DEST_DOMAIN]: new Set([ROUTER]) },
+        };
+        const extra = '0x' + 'cd'.repeat(32);
+        const writer = makeManager(context).createWriter(new EvmPrivateKeyQuoteSigner(quoteSignerWallet.privateKey), owner);
+        // issuedAt lands on the submit block's timestamp (hardhat mines at
+        // latest + 1); a standing quote must not be future-dated or the on-chain
+        // quoter rejects it with InvalidQuote().
+        const issuedAt = (await nowSec()) + 1;
+        const expiry = issuedAt + 7200;
+        await writer.submitQuote({
+            scope: {
+                destination: DEST_DOMAIN,
+                recipient: extra,
+                targetRouter: WARP_TARGET_ROUTER_NONE,
+                amount: WARP_QUOTE_AMOUNT_WILDCARD,
+            },
+            params: { maxFee: 33n, halfAmount: 44n },
+            issuedAt,
+            expiry,
+        });
+        // Without extras: the reader doesn't probe arbitrary recipients, so the
+        // entry stays invisible to the cross-VM read.
+        const withoutExtras = await makeManager(context)
+            .createReader()
+            .readStandingQuotes();
+        expect(withoutExtras.find((e) => e.scope.recipient === extra), 'reader should not discover arbitrary recipients without extras').to.equal(undefined);
+        // With extras: the reader probes (DEST_DOMAIN, extra) and finds it.
+        const withExtras = await makeManager(context)
+            .createReader()
+            .readStandingQuotes({ extraRecipients: new Set([extra]) });
+        const match = withExtras.find((e) => e.scope.recipient === extra);
+        assert(match, 'extras-probe should discover the arbitrary recipient entry');
+        expect(match.scope.destination).to.equal(DEST_DOMAIN);
+        expect(match.params.maxFee).to.equal(33n);
+        expect(match.params.halfAmount).to.equal(44n);
+    });
+    it('enumerateCandidates yields only `targetRouter === none` scopes (EVM has no CC dimension)', async () => {
+        const reader = makeManager({
+            knownRoutersPerDomain: {
+                [DEST_DOMAIN]: new Set([ROUTER, '0x' + 'bb'.repeat(32)]),
+            },
+        }).createReader();
+        const candidates = await reader.enumerateCandidates();
+        expect(candidates.length).to.be.greaterThan(0);
+        expect(candidates.every((s) => s.targetRouter === WARP_TARGET_ROUTER_NONE)).to.equal(true);
+    });
+});
+//# sourceMappingURL=EvmQuoteReader.hardhat-test.js.map

package/dist/quote/EvmQuoteReader.hardhat-test.js.map

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

package/dist/quote/EvmQuoteReader.js

@@ -0,0 +1,91 @@
+import { OffchainQuotedLinearFee__factory } from '@recoillink/core';
+import { WARP_QUOTE_AMOUNT_WILDCARD, WARP_TARGET_ROUTER_NONE, WILDCARD_DESTINATION_DOMAIN, enumerateWarpQuoteCandidates, } from '@recoillink/provider-sdk/quote';
+/**
+ * Reads standing offchain-quote entries from a deployed `OffchainQuotedLinearFee`.
+ * The contract stores standing quotes in a non-enumerable `quotes(dest, recipient)`
+ * mapping keyed by `(uint32 destination, bytes32 recipient)`, so the reader
+ * enumerates the `(dest, recipient)` candidates the cross-VM helper produces and
+ * queries each — dropping `expiry == 0` (unset slots).
+ *
+ * EVM has no on-chain `targetRouter` dimension; returned entries set
+ * `targetRouter = WARP_TARGET_ROUTER_NONE`. When this leaf sits under a
+ * CrossCollateralRoutingFee, callers that need to distinguish sibling-leaf
+ * entries label them at a higher layer using the deploy-config router key.
+ */
+export class EvmQuoteReader {
+    provider;
+    feeAddress;
+    context;
+    constructor(provider, feeAddress, context) {
+        this.provider = provider;
+        this.feeAddress = feeAddress;
+        this.context = context;
+    }
+    async enumerateCandidates() {
+        return enumerateWarpQuoteCandidates(this.context).filter((s) => s.targetRouter === WARP_TARGET_ROUTER_NONE);
+    }
+    async readStandingQuotes(opts) {
+        const candidates = await this.enumerateCandidates();
+        const contract = OffchainQuotedLinearFee__factory.connect(this.feeAddress, this.provider);
+        const seen = new Set();
+        const uniqueKeys = [];
+        for (const scope of candidates) {
+            const key = `${scope.destination}|${scope.recipient}`;
+            if (seen.has(key))
+                continue;
+            seen.add(key);
+            uniqueKeys.push({
+                destination: scope.destination,
+                recipient: scope.recipient,
+            });
+        }
+        // EVM `quotes(dest, recipient)` is non-enumerable, so probe any extra
+        // recipients the caller knows about. Cross with every known destination
+        // and with WILDCARD_DESTINATION_DOMAIN to mirror the standard enumeration.
+        if (opts?.extraRecipients?.size) {
+            const knownDestinations = Object.keys(this.context.knownRoutersPerDomain)
+                .map(Number)
+                .filter(Number.isInteger);
+            for (const recipient of opts.extraRecipients) {
+                for (const destination of knownDestinations) {
+                    const key = `${destination}|${recipient}`;
+                    if (seen.has(key))
+                        continue;
+                    seen.add(key);
+                    uniqueKeys.push({ destination, recipient });
+                }
+                const wildKey = `${WILDCARD_DESTINATION_DOMAIN}|${recipient}`;
+                if (!seen.has(wildKey)) {
+                    seen.add(wildKey);
+                    uniqueKeys.push({
+                        destination: WILDCARD_DESTINATION_DOMAIN,
+                        recipient,
+                    });
+                }
+            }
+        }
+        const results = [];
+        for (const { destination, recipient } of uniqueKeys) {
+            const stored = await contract.quotes(destination, recipient);
+            const expiry = Number(stored.expiry);
+            if (expiry === 0)
+                continue;
+            results.push({
+                scope: {
+                    destination,
+                    recipient,
+                    targetRouter: WARP_TARGET_ROUTER_NONE,
+                    amount: WARP_QUOTE_AMOUNT_WILDCARD,
+                },
+                params: {
+                    maxFee: BigInt(stored.maxFee.toString()),
+                    halfAmount: BigInt(stored.halfAmount.toString()),
+                },
+                issuedAt: Number(stored.issuedAt),
+                expiry,
+            });
+        }
+        return results;
+    }
+}
+//# sourceMappingURL=EvmQuoteReader.js.map

package/dist/quote/EvmQuoteReader.js.map

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

package/dist/quote/EvmQuoteWriter.d.ts

@@ -0,0 +1,16 @@
+import { type Signer } from 'ethers';
+import { type CreateWarpQuoteRequest, type IRawWarpQuoteWriter, type RawQuoteSigner, type SubmittedWarpQuote } from '@recoillink/provider-sdk/quote';
+/**
+ * Submits offchain-signed warp quotes to a deployed `OffchainQuotedLinearFee`.
+ * Pre-flights the quote signer's authorization on-chain (`isQuoteSigner`) and
+ * binds the EIP-712 `submitter` field to the tx-submitter's address so only
+ * the configured tx signer may broadcast the resulting payload.
+ */
+export declare class EvmQuoteWriter implements IRawWarpQuoteWriter {
+    private readonly txSigner;
+    private readonly quoteSigner;
+    private readonly feeAddress;
+    constructor(txSigner: Signer, quoteSigner: RawQuoteSigner, feeAddress: string);
+    submitQuote(req: CreateWarpQuoteRequest): Promise<SubmittedWarpQuote>;
+}
+//# sourceMappingURL=EvmQuoteWriter.d.ts.map

package/dist/quote/EvmQuoteWriter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EvmQuoteWriter.d.ts","sourceRoot":"","sources":["../../src/quote/EvmQuoteWriter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAwB,MAAM,QAAQ,CAAC;AAG3D,OAAO,EACL,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EAExB,MAAM,gCAAgC,CAAC;AAQxC;;;;;GAKG;AACH,qBAAa,cAAe,YAAW,mBAAmB;IAEtD,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAH7B,YACmB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,cAAc,EAC3B,UAAU,EAAE,MAAM,EACjC;IAEE,WAAW,CAAC,GAAG,EAAE,sBAAsB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAoD1E;CACF"}

package/dist/quote/EvmQuoteWriter.hardhat-test.d.ts

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

package/dist/quote/EvmQuoteWriter.hardhat-test.d.ts.map

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