crypto-aio 0.0.3 → 0.1.0

package/dist/adapters/evm/web3-client.js

@@ -0,0 +1,159 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.web3DriverFactory = exports.Web3Client = void 0;
+/**
+ * `Web3Client`: the web3 v4 strategy. Its I/O goes through an EIP-1193 provider object whose
+ * `request` hands every call to the core transport, one request manager per call so each
+ * request carries that call's tags. ChainSafe sunset web3.js in 2025 (4.16.0 is the last
+ * release); ethers stays the default.
+ */
+const web3_1 = require("web3");
+const error_1 = require("../../core/errors/error");
+const client_1 = require("./client");
+const driver_1 = require("./driver");
+const rpc_1 = require("./rpc");
+/** An EIP-1193 provider bridged onto the core transport through `call`. */
+function eip1193(call) {
+    // An async function, so web3 4.16 takes its EIP-1193 path (it checks the function's
+    // constructor name), not its legacy request-provider path. The EIP-1193 path arms no
+    // timer, so a driver request never waits on one.
+    return { request: async ({ method, params }) => call(method, params) };
+}
+const fn = (name, inputs) => ({
+    name,
+    type: 'function',
+    inputs: inputs.map((type, i) => ({ type, name: `a${i}` })),
+});
+const TRANSFER_TOPIC = web3_1.eth.abi.encodeEventSignature('Transfer(address,address,uint256)');
+const web3Abi = {
+    transferTopic: TRANSFER_TOPIC,
+    encodeTransfer: (to, amount) => web3_1.eth.abi.encodeFunctionCall(fn('transfer', ['address', 'uint256']), [to, amount]),
+    encodeBalanceOf: (owner) => web3_1.eth.abi.encodeFunctionCall(fn('balanceOf', ['address']), [owner]),
+    encodeDecimals: () => web3_1.eth.abi.encodeFunctionCall(fn('decimals', []), []),
+    encodeSymbol: () => web3_1.eth.abi.encodeFunctionCall(fn('symbol', []), []),
+    encodeGetL1Fee: (unsignedTx) => web3_1.eth.abi.encodeFunctionCall(fn('getL1Fee', ['bytes']), [unsignedTx]),
+    decodeUint256: (data) => {
+        if (!client_1.ABI_WORD.test(data))
+            throw new Error('not one ABI word');
+        return BigInt(web3_1.eth.abi.decodeParameter('uint256', data));
+    },
+    decodeString: (data) => web3_1.eth.abi.decodeParameter('string', data),
+    decodeTransfer: (log) => {
+        const words = (0, client_1.transferLogWords)(log, TRANSFER_TOPIC);
+        if (!words)
+            return null;
+        const address = (word) => web3_1.utils.toChecksumAddress(web3_1.eth.abi.decodeParameter('address', word));
+        return {
+            from: address(words.from),
+            to: address(words.to),
+            amount: BigInt(web3_1.eth.abi.decodeParameter('uint256', words.data)),
+        };
+    },
+};
+/** RLP of a list of byte strings (web3 exposes no RLP encoder; used for legacy payloads). */
+function rlpList(items) {
+    const length = (size, offset) => {
+        if (size < 56)
+            return [offset + size];
+        const bytes = [];
+        for (let rest = size; rest > 0; rest = Math.floor(rest / 256))
+            bytes.unshift(rest % 256);
+        return [offset + 55 + bytes.length, ...bytes];
+    };
+    const encoded = items.map((item) => item.length === 1 && item[0] < 0x80
+        ? [...item]
+        : [...length(item.length, 0x80), ...item]);
+    const payload = encoded.flat();
+    return Uint8Array.from([...length(payload.length, 0xc0), ...payload]);
+}
+class Web3Client extends client_1.EvmClientBase {
+    library = 'web3';
+    abi = web3Abi;
+    #transport;
+    #common;
+    constructor(transport, chainId) {
+        super(chainId);
+        this.#transport = transport;
+        this.#common = web3_1.eth.accounts.Common.custom({ chainId: Number(chainId), networkId: Number(chainId) }, { hardfork: 'london' });
+    }
+    send(method, params, tags) {
+        return (0, rpc_1.throughSdk)(async (call) => {
+            const manager = new web3_1.core.Web3RequestManager(eip1193(call));
+            try {
+                return await manager.send({ method, params: [...params] });
+            }
+            catch (error) {
+                // web3 reads an answer shaped like a JSON-RPC error as an error of its own.
+                // A transport failure is put back by `throughSdk`; anything else is the answer's.
+                if ((0, error_1.isCryptoAioError)(error))
+                    throw error;
+                throw new error_1.ProviderError('PROVIDER_UNAVAILABLE', 'malformed JSON-RPC answer');
+            }
+        }, this.#transport, tags);
+    }
+    isAddress(value) {
+        return client_1.ADDRESS.test(value) && web3_1.utils.isAddress(value);
+    }
+    checksum(address) {
+        return this.checked(address, (value) => {
+            if (!web3_1.utils.isAddress(value))
+                throw new Error('bad checksum');
+            return web3_1.utils.toChecksumAddress(value);
+        });
+    }
+    addressFromPublicKey(publicKey) {
+        // The shared strict decode, so both clients refuse exactly the same keys.
+        const digest = web3_1.utils.keccak256((0, client_1.uncompressedPublicKey)(publicKey).slice(1));
+        return web3_1.utils.toChecksumAddress(`0x${digest.slice(-40)}`);
+    }
+    encodeUnsigned(tx) {
+        const message = this.#tx(tx).getMessageToSign(false);
+        return web3_1.utils.bytesToHex(Array.isArray(message) ? rlpList(message) : message);
+    }
+    hashUnsigned(tx) {
+        return web3_1.utils.bytesToHex(this.#tx(tx).getMessageToSign(true));
+    }
+    encodeSigned(tx, signature) {
+        const signed = this.#tx(tx, signature);
+        return {
+            raw: web3_1.utils.bytesToHex(signed.serialize()),
+            hash: web3_1.utils.bytesToHex(signed.hash()),
+        };
+    }
+    createNative() {
+        const call = (method, params) => (0, rpc_1.transportCall)(this.#transport, method, params, (0, rpc_1.nativeTags)(method));
+        return { client: new web3_1.Web3(eip1193(call)) };
+    }
+    #tx(tx, signature) {
+        const common = {
+            nonce: tx.nonce,
+            to: tx.to,
+            value: tx.value,
+            data: tx.data,
+            gasLimit: tx.gasLimit,
+        };
+        const options = { common: this.#common };
+        if (tx.type === 'eip1559') {
+            return web3_1.eth.accounts.FeeMarketEIP1559Transaction.fromTxData({
+                ...common,
+                chainId: tx.chainId,
+                maxFeePerGas: tx.maxFeePerGas,
+                maxPriorityFeePerGas: tx.maxPriorityFeePerGas,
+                accessList: [],
+                ...(signature
+                    ? { v: BigInt(signature.yParity), r: signature.r, s: signature.s }
+                    : {}),
+            }, options);
+        }
+        const v = signature && this.chainId * 2n + 35n + BigInt(signature.yParity);
+        return web3_1.eth.accounts.Transaction.fromTxData({
+            ...common,
+            gasPrice: tx.gasPrice,
+            ...(signature ? { v, r: signature.r, s: signature.s } : {}),
+        }, options);
+    }
+}
+exports.Web3Client = Web3Client;
+/** The `web3` adapter's driver factory; the manifest's `load()` returns it. */
+exports.web3DriverFactory = (0, driver_1.evmDriverFactory)((transport, chainId) => new Web3Client(transport, chainId));
+//# sourceMappingURL=web3-client.js.map

package/dist/adapters/evm/web3-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web3-client.js","sourceRoot":"","sources":["../../../src/adapters/evm/web3-client.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,+BAA8C;AAE9C,mDAA0E;AAE1E,qCAMkB;AAClB,qCAA4C;AAC5C,+BAA8D;AAO9D,2EAA2E;AAC3E,SAAS,OAAO,CACd,IAA2D;IAE3D,oFAAoF;IACpF,qFAAqF;IACrF,iDAAiD;IACjD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;AACzE,CAAC;AAED,MAAM,EAAE,GAAG,CAAC,IAAY,EAAE,MAAyB,EAAE,EAAE,CAAC,CAAC;IACvD,IAAI;IACJ,IAAI,EAAE,UAAU;IAChB,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;CAC3D,CAAC,CAAC;AACH,MAAM,cAAc,GAAG,UAAG,CAAC,GAAG,CAAC,oBAAoB,CAAC,mCAAmC,CAAC,CAAC;AAEzF,MAAM,OAAO,GAAW;IACtB,aAAa,EAAE,cAAc;IAC7B,cAAc,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAC7B,UAAG,CAAC,GAAG,CAAC,kBAAkB,CAAC,EAAE,CAAC,UAAU,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IAClF,eAAe,EAAE,CAAC,KAAK,EAAE,EAAE,CACzB,UAAG,CAAC,GAAG,CAAC,kBAAkB,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;IACnE,cAAc,EAAE,GAAG,EAAE,CAAC,UAAG,CAAC,GAAG,CAAC,kBAAkB,CAAC,EAAE,CAAC,UAAU,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;IACxE,YAAY,EAAE,GAAG,EAAE,CAAC,UAAG,CAAC,GAAG,CAAC,kBAAkB,CAAC,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;IACpE,cAAc,EAAE,CAAC,UAAU,EAAE,EAAE,CAC7B,UAAG,CAAC,GAAG,CAAC,kBAAkB,CAAC,EAAE,CAAC,UAAU,EAAE,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC;IACrE,aAAa,EAAE,CAAC,IAAI,EAAE,EAAE;QACtB,IAAI,CAAC,iBAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;QAC9D,OAAO,MAAM,CAAC,UAAG,CAAC,GAAG,CAAC,eAAe,CAAC,SAAS,EAAE,IAAI,CAAW,CAAC,CAAC;IACpE,CAAC;IACD,YAAY,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,UAAG,CAAC,GAAG,CAAC,eAAe,CAAC,QAAQ,EAAE,IAAI,CAAW;IACzE,cAAc,EAAE,CAAC,GAAG,EAAE,EAAE;QACtB,MAAM,KAAK,GAAG,IAAA,yBAAgB,EAAC,GAAG,EAAE,cAAc,CAAC,CAAC;QACpD,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QACxB,MAAM,OAAO,GAAG,CAAC,IAAY,EAAE,EAAE,CAC/B,YAAK,CAAC,iBAAiB,CAAC,UAAG,CAAC,GAAG,CAAC,eAAe,CAAC,SAAS,EAAE,IAAI,CAAW,CAAC,CAAC;QAC9E,OAAO;YACL,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC;YACzB,EAAE,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACrB,MAAM,EAAE,MAAM,CAAC,UAAG,CAAC,GAAG,CAAC,eAAe,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAW,CAAC;SACzE,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,6FAA6F;AAC7F,SAAS,OAAO,CAAC,KAA4B;IAC3C,MAAM,MAAM,GAAG,CAAC,IAAY,EAAE,MAAc,EAAY,EAAE;QACxD,IAAI,IAAI,GAAG,EAAE;YAAE,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;QACtC,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,IAAI,IAAI,GAAG,IAAI,EAAE,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,GAAG,CAAC;YAC3D,KAAK,CAAC,OAAO,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC;QAC5B,OAAO,CAAC,MAAM,GAAG,EAAE,GAAG,KAAK,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC;IAChD,CAAC,CAAC;IACF,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACjC,IAAI,CAAC,MAAM,KAAK,CAAC,IAAK,IAAI,CAAC,CAAC,CAAY,GAAG,IAAI;QAC7C,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;QACX,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,CAC5C,CAAC;IACF,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAC/B,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC;AACxE,CAAC;AAED,MAAa,UAAW,SAAQ,sBAAa;IAClC,OAAO,GAAG,MAAM,CAAC;IACjB,GAAG,GAAG,OAAO,CAAC;IACd,UAAU,CAAY;IACtB,OAAO,CAA2C;IAE3D,YAAY,SAAoB,EAAE,OAAe;QAC/C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC5B,IAAI,CAAC,OAAO,GAAG,UAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CACvC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,EACxD,EAAE,QAAQ,EAAE,QAAQ,EAAE,CACvB,CAAC;IACJ,CAAC;IAES,IAAI,CACZ,MAAc,EACd,MAA0B,EAC1B,IAAiB;QAEjB,OAAO,IAAA,gBAAU,EACf,KAAK,EAAE,IAAI,EAAE,EAAE;YACb,MAAM,OAAO,GAAG,IAAI,WAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,IAAI,CAAU,CAAC,CAAC;YACpE,IAAI,CAAC;gBACH,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,MAAM,CAAC,EAAW,CAAC,CAAC;YACtE,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,4EAA4E;gBAC5E,kFAAkF;gBAClF,IAAI,IAAA,wBAAgB,EAAC,KAAK,CAAC;oBAAE,MAAM,KAAK,CAAC;gBACzC,MAAM,IAAI,qBAAa,CAAC,sBAAsB,EAAE,2BAA2B,CAAC,CAAC;YAC/E,CAAC;QACH,CAAC,EACD,IAAI,CAAC,UAAU,EACf,IAAI,CACL,CAAC;IACJ,CAAC;IAED,SAAS,CAAC,KAAa;QACrB,OAAO,gBAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,YAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACvD,CAAC;IAED,QAAQ,CAAC,OAAe;QACtB,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YACrC,IAAI,CAAC,YAAK,CAAC,SAAS,CAAC,KAAK,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,CAAC;YAC7D,OAAO,YAAK,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;IACL,CAAC;IAED,oBAAoB,CAAC,SAAqB;QACxC,0EAA0E;QAC1E,MAAM,MAAM,GAAG,YAAK,CAAC,SAAS,CAAC,IAAA,8BAAqB,EAAC,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1E,OAAO,YAAK,CAAC,iBAAiB,CAAC,KAAK,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAC3D,CAAC;IAES,cAAc,CAAC,EAAe;QACtC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;QACrD,OAAO,YAAK,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAC/E,CAAC;IAES,YAAY,CAAC,EAAe;QACpC,OAAO,YAAK,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/D,CAAC;IAES,YAAY,CACpB,EAAe,EACf,SAAuB;QAEvB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;QACvC,OAAO;YACL,GAAG,EAAE,YAAK,CAAC,UAAU,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;YACzC,IAAI,EAAE,YAAK,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;SACtC,CAAC;IACJ,CAAC;IAED,YAAY;QACV,MAAM,IAAI,GAAG,CAAC,MAAc,EAAE,MAAe,EAAE,EAAE,CAC/C,IAAA,mBAAa,EAAC,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,IAAA,gBAAU,EAAC,MAAM,CAAC,CAAC,CAAC;QACrE,OAAO,EAAE,MAAM,EAAE,IAAI,WAAI,CAAC,OAAO,CAAC,IAAI,CAAU,CAAC,EAAE,CAAC;IACtD,CAAC;IAED,GAAG,CAAC,EAAe,EAAE,SAAwB;QAC3C,MAAM,MAAM,GAAG;YACb,KAAK,EAAE,EAAE,CAAC,KAAK;YACf,EAAE,EAAE,EAAE,CAAC,EAAE;YACT,KAAK,EAAE,EAAE,CAAC,KAAK;YACf,IAAI,EAAE,EAAE,CAAC,IAAI;YACb,QAAQ,EAAE,EAAE,CAAC,QAAQ;SACtB,CAAC;QACF,MAAM,OAAO,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;QACzC,IAAI,EAAE,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC1B,OAAO,UAAG,CAAC,QAAQ,CAAC,2BAA2B,CAAC,UAAU,CACxD;gBACE,GAAG,MAAM;gBACT,OAAO,EAAE,EAAE,CAAC,OAAO;gBACnB,YAAY,EAAE,EAAE,CAAC,YAAY;gBAC7B,oBAAoB,EAAE,EAAE,CAAC,oBAAoB;gBAC7C,UAAU,EAAE,EAAE;gBACd,GAAG,CAAC,SAAS;oBACX,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC,EAAE;oBAClE,CAAC,CAAC,EAAE,CAAC;aACR,EACD,OAAO,CACR,CAAC;QACJ,CAAC;QACD,MAAM,CAAC,GAAG,SAAS,IAAI,IAAI,CAAC,OAAO,GAAG,EAAE,GAAG,GAAG,GAAG,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAC3E,OAAO,UAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,UAAU,CACxC;YACE,GAAG,MAAM;YACT,QAAQ,EAAE,EAAE,CAAC,QAAQ;YACrB,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC5D,EACD,OAAO,CACR,CAAC;IACJ,CAAC;CACF;AAlHD,gCAkHC;AAED,+EAA+E;AAClE,QAAA,iBAAiB,GAAG,IAAA,yBAAgB,EAC/C,CAAC,SAAS,EAAE,OAAO,EAAE,EAAE,CAAC,IAAI,UAAU,CAAC,SAAS,EAAE,OAAO,CAAC,CAC3D,CAAC","sourcesContent":["/**\n * `Web3Client`: the web3 v4 strategy. Its I/O goes through an EIP-1193 provider object whose\n * `request` hands every call to the core transport, one request manager per call so each\n * request carries that call's tags. ChainSafe sunset web3.js in 2025 (4.16.0 is the last\n * release); ethers stays the default.\n */\nimport { Web3, core, eth, utils } from 'web3';\nimport type { DisposableNativeClient } from '../../core/driver/types';\nimport { ProviderError, isCryptoAioError } from '../../core/errors/error';\nimport type { Transport } from '../../core/transport/types';\nimport {\n  ABI_WORD,\n  ADDRESS,\n  EvmClientBase,\n  transferLogWords,\n  uncompressedPublicKey,\n} from './client';\nimport { evmDriverFactory } from './driver';\nimport { nativeTags, throughSdk, transportCall } from './rpc';\nimport type { EvmAbi, EvmCallTags, EvmSignature, EvmTxFields } from './types';\n\ninterface Eip1193Provider {\n  request(args: { readonly method: string; readonly params?: unknown }): Promise<unknown>;\n}\n\n/** An EIP-1193 provider bridged onto the core transport through `call`. */\nfunction eip1193(\n  call: (method: string, params: unknown) => Promise<unknown>,\n): Eip1193Provider {\n  // An async function, so web3 4.16 takes its EIP-1193 path (it checks the function's\n  // constructor name), not its legacy request-provider path. The EIP-1193 path arms no\n  // timer, so a driver request never waits on one.\n  return { request: async ({ method, params }) => call(method, params) };\n}\n\nconst fn = (name: string, inputs: readonly string[]) => ({\n  name,\n  type: 'function',\n  inputs: inputs.map((type, i) => ({ type, name: `a${i}` })),\n});\nconst TRANSFER_TOPIC = eth.abi.encodeEventSignature('Transfer(address,address,uint256)');\n\nconst web3Abi: EvmAbi = {\n  transferTopic: TRANSFER_TOPIC,\n  encodeTransfer: (to, amount) =>\n    eth.abi.encodeFunctionCall(fn('transfer', ['address', 'uint256']), [to, amount]),\n  encodeBalanceOf: (owner) =>\n    eth.abi.encodeFunctionCall(fn('balanceOf', ['address']), [owner]),\n  encodeDecimals: () => eth.abi.encodeFunctionCall(fn('decimals', []), []),\n  encodeSymbol: () => eth.abi.encodeFunctionCall(fn('symbol', []), []),\n  encodeGetL1Fee: (unsignedTx) =>\n    eth.abi.encodeFunctionCall(fn('getL1Fee', ['bytes']), [unsignedTx]),\n  decodeUint256: (data) => {\n    if (!ABI_WORD.test(data)) throw new Error('not one ABI word');\n    return BigInt(eth.abi.decodeParameter('uint256', data) as bigint);\n  },\n  decodeString: (data) => eth.abi.decodeParameter('string', data) as string,\n  decodeTransfer: (log) => {\n    const words = transferLogWords(log, TRANSFER_TOPIC);\n    if (!words) return null;\n    const address = (word: string) =>\n      utils.toChecksumAddress(eth.abi.decodeParameter('address', word) as string);\n    return {\n      from: address(words.from),\n      to: address(words.to),\n      amount: BigInt(eth.abi.decodeParameter('uint256', words.data) as bigint),\n    };\n  },\n};\n\n/** RLP of a list of byte strings (web3 exposes no RLP encoder; used for legacy payloads). */\nfunction rlpList(items: readonly Uint8Array[]): Uint8Array {\n  const length = (size: number, offset: number): number[] => {\n    if (size < 56) return [offset + size];\n    const bytes: number[] = [];\n    for (let rest = size; rest > 0; rest = Math.floor(rest / 256))\n      bytes.unshift(rest % 256);\n    return [offset + 55 + bytes.length, ...bytes];\n  };\n  const encoded = items.map((item) =>\n    item.length === 1 && (item[0] as number) < 0x80\n      ? [...item]\n      : [...length(item.length, 0x80), ...item],\n  );\n  const payload = encoded.flat();\n  return Uint8Array.from([...length(payload.length, 0xc0), ...payload]);\n}\n\nexport class Web3Client extends EvmClientBase {\n  readonly library = 'web3';\n  readonly abi = web3Abi;\n  readonly #transport: Transport;\n  readonly #common: InstanceType<typeof eth.accounts.Common>;\n\n  constructor(transport: Transport, chainId: bigint) {\n    super(chainId);\n    this.#transport = transport;\n    this.#common = eth.accounts.Common.custom(\n      { chainId: Number(chainId), networkId: Number(chainId) },\n      { hardfork: 'london' },\n    );\n  }\n\n  protected send(\n    method: string,\n    params: readonly unknown[],\n    tags: EvmCallTags,\n  ): Promise<unknown> {\n    return throughSdk(\n      async (call) => {\n        const manager = new core.Web3RequestManager(eip1193(call) as never);\n        try {\n          return await manager.send({ method, params: [...params] } as never);\n        } catch (error) {\n          // web3 reads an answer shaped like a JSON-RPC error as an error of its own.\n          // A transport failure is put back by `throughSdk`; anything else is the answer's.\n          if (isCryptoAioError(error)) throw error;\n          throw new ProviderError('PROVIDER_UNAVAILABLE', 'malformed JSON-RPC answer');\n        }\n      },\n      this.#transport,\n      tags,\n    );\n  }\n\n  isAddress(value: string): boolean {\n    return ADDRESS.test(value) && utils.isAddress(value);\n  }\n\n  checksum(address: string): string {\n    return this.checked(address, (value) => {\n      if (!utils.isAddress(value)) throw new Error('bad checksum');\n      return utils.toChecksumAddress(value);\n    });\n  }\n\n  addressFromPublicKey(publicKey: Uint8Array): string {\n    // The shared strict decode, so both clients refuse exactly the same keys.\n    const digest = utils.keccak256(uncompressedPublicKey(publicKey).slice(1));\n    return utils.toChecksumAddress(`0x${digest.slice(-40)}`);\n  }\n\n  protected encodeUnsigned(tx: EvmTxFields): string {\n    const message = this.#tx(tx).getMessageToSign(false);\n    return utils.bytesToHex(Array.isArray(message) ? rlpList(message) : message);\n  }\n\n  protected hashUnsigned(tx: EvmTxFields): string {\n    return utils.bytesToHex(this.#tx(tx).getMessageToSign(true));\n  }\n\n  protected encodeSigned(\n    tx: EvmTxFields,\n    signature: EvmSignature,\n  ): { raw: string; hash: string } {\n    const signed = this.#tx(tx, signature);\n    return {\n      raw: utils.bytesToHex(signed.serialize()),\n      hash: utils.bytesToHex(signed.hash()),\n    };\n  }\n\n  createNative(): DisposableNativeClient {\n    const call = (method: string, params: unknown) =>\n      transportCall(this.#transport, method, params, nativeTags(method));\n    return { client: new Web3(eip1193(call) as never) };\n  }\n\n  #tx(tx: EvmTxFields, signature?: EvmSignature) {\n    const common = {\n      nonce: tx.nonce,\n      to: tx.to,\n      value: tx.value,\n      data: tx.data,\n      gasLimit: tx.gasLimit,\n    };\n    const options = { common: this.#common };\n    if (tx.type === 'eip1559') {\n      return eth.accounts.FeeMarketEIP1559Transaction.fromTxData(\n        {\n          ...common,\n          chainId: tx.chainId,\n          maxFeePerGas: tx.maxFeePerGas,\n          maxPriorityFeePerGas: tx.maxPriorityFeePerGas,\n          accessList: [],\n          ...(signature\n            ? { v: BigInt(signature.yParity), r: signature.r, s: signature.s }\n            : {}),\n        },\n        options,\n      );\n    }\n    const v = signature && this.chainId * 2n + 35n + BigInt(signature.yParity);\n    return eth.accounts.Transaction.fromTxData(\n      {\n        ...common,\n        gasPrice: tx.gasPrice,\n        ...(signature ? { v, r: signature.r, s: signature.s } : {}),\n      },\n      options,\n    );\n  }\n}\n\n/** The `web3` adapter's driver factory; the manifest's `load()` returns it. */\nexport const web3DriverFactory = evmDriverFactory(\n  (transport, chainId) => new Web3Client(transport, chainId),\n);\n"]}

package/dist/adapters/solana/builder.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Solana transfers: SystemProgram and SPL `transferChecked`, with
+ * `createAssociatedTokenAccountIdempotent` when the recipient's token account is missing,
+ * an optional Memo, and compute-budget instructions. Expiry ordering: the recent blockhash's
+ * `lastValidBlockHeight` is the Attempt's ordering, recorded with the blockhash and the slot
+ * of its block (`SolanaExpiryOrdering`) so proofs can attest the height before a
+ * verdict rests on it. One `ed25519` signing request per required signer, over the
+ * message; the Attempt ref is the first signature (canonical).
+ *
+ * Nothing is signed before the compiled bytes are read back, SDK-free (`wire.ts`): one legacy
+ * message whose only signer is the sender, on our blockhash, with exactly our instructions,
+ * whose transfer pays the intent's recipient (the landing guard in `decode.ts` trusts it).
+ * No transaction over the 1,232-byte packet limit is simulated, quoted, signed or sent.
+ */
+import type { Broadcaster, TxBuilder } from '../../core/driver/types';
+import { type SolanaContext } from './reader';
+export declare function createSolanaBuilder(ctx: SolanaContext): TxBuilder;
+export declare function createSolanaBroadcaster(ctx: SolanaContext): Broadcaster;