@faremeter/payment-evm 0.13.0 → 0.15.0

package/README.md

@@ -0,0 +1,33 @@
+# @faremeter/payment-evm
+
+EVM payment scheme implementations for the x402 protocol, supporting EIP-3009 gasless USDC transfers.
+
+## Installation
+
+```bash
+pnpm install @faremeter/payment-evm
+```
+
+## Features
+
+- Gasless transfers (EIP-3009)
+- USDC payments on Base, Polygon, Skale, and more
+- EIP-712 typed signatures
+- Facilitator pays gas fees
+- Secure authorization pattern
+
+## API Reference
+
+<!-- TSDOC_START -->
+
+<!-- TSDOC_END -->
+
+## Related Packages
+
+- [@faremeter/wallet-evm](https://www.npmjs.com/package/@faremeter/wallet-evm) - EVM wallet adapter
+- [@faremeter/fetch](https://www.npmjs.com/package/@faremeter/fetch) - Client fetch wrapper
+- [@faremeter/facilitator](https://www.npmjs.com/package/@faremeter/facilitator) - Payment facilitator
+
+## License
+
+LGPL-3.0-only

package/dist/src/erc20.d.ts

@@ -0,0 +1,12 @@
+import { type PublicClient } from "viem";
+import { type Address } from "@faremeter/types/evm";
+export interface GetTokenBalanceArgs {
+    account: Address;
+    asset: Address;
+    client: PublicClient;
+}
+export declare function getTokenBalance(args: GetTokenBalanceArgs): Promise<{
+    amount: bigint;
+    decimals: number;
+}>;
+//# sourceMappingURL=erc20.d.ts.map

package/dist/src/erc20.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"erc20.d.ts","sourceRoot":"","sources":["../../src/erc20.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,MAAM,CAAC;AACzC,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEpD,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,mBAAmB;;;GA4C9D"}

package/dist/src/erc20.js

@@ -0,0 +1,44 @@
+import {} from "viem";
+import {} from "@faremeter/types/evm";
+export async function getTokenBalance(args) {
+    const { account, asset, client } = args;
+    const [balance, decimals] = await client.multicall({
+        contracts: [
+            {
+                address: asset,
+                abi: [
+                    {
+                        name: "balanceOf",
+                        type: "function",
+                        stateMutability: "view",
+                        inputs: [{ type: "address" }],
+                        outputs: [{ type: "uint256" }],
+                    },
+                ],
+                functionName: "balanceOf",
+                args: [account],
+            },
+            {
+                address: asset,
+                abi: [
+                    {
+                        name: "decimals",
+                        type: "function",
+                        stateMutability: "view",
+                        inputs: [],
+                        outputs: [{ type: "uint8" }],
+                    },
+                ],
+                functionName: "decimals",
+                args: [],
+            },
+        ],
+    });
+    if (decimals.status !== "success" || balance.status !== "success") {
+        throw new Error("failed to query balance");
+    }
+    return {
+        amount: balance.result,
+        decimals: decimals.result,
+    };
+}

package/dist/src/exact/facilitator.d.ts

@@ -1,4 +1,4 @@
-import { type ChainInfo } from "@faremeter/types/evm";
+import { type ChainInfoWithRPC } from "@faremeter/types/evm";
 import { type FacilitatorHandler } from "@faremeter/types/facilitator";
 import type { Transport } from "viem";
 import { type KnownX402Network, type AssetNameOrContractInfo } from "@faremeter/info/evm";
@@ -6,6 +6,6 @@ type CreateFacilitatorHandlerOpts = {
     network?: KnownX402Network;
     transport?: Transport;
 };
-export declare function createFacilitatorHandler(chain: ChainInfo, privateKey: string, assetNameOrInfo: AssetNameOrContractInfo, opts?: CreateFacilitatorHandlerOpts): Promise<FacilitatorHandler>;
+export declare function createFacilitatorHandler(chain: ChainInfoWithRPC, privateKey: string, assetNameOrInfo: AssetNameOrContractInfo, opts?: CreateFacilitatorHandlerOpts): Promise<FacilitatorHandler>;
 export {};
 //# sourceMappingURL=facilitator.d.ts.map

package/dist/src/exact/facilitator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"facilitator.d.ts","sourceRoot":"","sources":["../../../src/exact/facilitator.ts"],"names":[],"mappings":"AAQA,OAAO,EAAgB,KAAK,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAGvE,OAAO,KAAK,EAAgB,SAAS,EAAE,MAAM,MAAM,CAAC;AAYpD,OAAO,EAEL,KAAK,gBAAgB,EAErB,KAAK,uBAAuB,EAC7B,MAAM,qBAAqB,CAAC;AAuB7B,KAAK,4BAA4B,GAAG;IAClC,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB,CAAC;AACF,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,SAAS,EAChB,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,uBAAuB,EACxC,IAAI,GAAE,4BAAiC,GACtC,OAAO,CAAC,kBAAkB,CAAC,CA2U7B"}
+{"version":3,"file":"facilitator.d.ts","sourceRoot":"","sources":["../../../src/exact/facilitator.ts"],"names":[],"mappings":"AAQA,OAAO,EAAgB,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC3E,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAGvE,OAAO,KAAK,EAAgB,SAAS,EAAE,MAAM,MAAM,CAAC;AAapD,OAAO,EAEL,KAAK,gBAAgB,EAErB,KAAK,uBAAuB,EAC7B,MAAM,qBAAqB,CAAC;AAuB7B,KAAK,4BAA4B,GAAG;IAClC,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB,CAAC;AACF,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,gBAAgB,EACvB,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,uBAAuB,EACxC,IAAI,GAAE,4BAAiC,GACtC,OAAO,CAAC,kBAAkB,CAAC,CAqV7B"}

package/dist/src/exact/facilitator.js

@@ -1,7 +1,7 @@
 import { isPrivateKey } from "@faremeter/types/evm";
 import {} from "@faremeter/types/facilitator";
 import { type } from "arktype";
-import { createPublicClient, createWalletClient, http, verifyTypedData, encodeFunctionData, isAddress, } from "viem";
+import { createPublicClient, createWalletClient, http, verifyTypedData, encodeFunctionData, isAddress, defineChain, } from "viem";
 import { privateKeyToAccount } from "viem/accounts";
 import { lookupX402Network, findAssetInfo, } from "@faremeter/info/evm";
 import { X402_EXACT_SCHEME, TRANSFER_WITH_AUTHORIZATION_ABI, EIP712_TYPES, x402ExactPayload, } from "./constants.js";
@@ -30,7 +30,17 @@ export async function createFacilitatorHandler(chain, privateKey, assetNameOrInf
     const publicClient = createPublicClient({
         transport,
     });
+    // XXX - Temporarily work around typing problems related to trying to have a chain be null.
+    const ersatzChain = defineChain({
+        ...chain,
+        nativeCurrency: {
+            decimals: 0,
+            name: "",
+            symbol: "",
+        },
+    });
     const walletClient = createWalletClient({
+        chain: defineChain(ersatzChain),
         account,
         transport,
     });
@@ -241,7 +251,6 @@ export async function createFacilitatorHandler(chain, privateKey, assetNameOrInf
                 to: useForwarder ? domain.verifyingContract : asset,
                 data,
                 account: acct,
-                chain: null,
             });
             const serializedTransaction = await walletClient.signTransaction(request);
             const txHash = await publicClient.sendRawTransaction({

package/dist/src/exact/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/exact/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EACL,iBAAiB,EACjB,+BAA+B,EAC/B,YAAY,EACZ,gBAAgB,EAChB,YAAY,GACb,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/exact/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EACL,iBAAiB,EACjB,+BAA+B,EAC/B,YAAY,EACZ,gBAAgB,EAChB,YAAY,GACb,MAAM,aAAa,CAAC"}

package/dist/src/index.d.ts

@@ -1,2 +1,3 @@
 export * as exact from "./exact/index.js";
+export * as erc20 from "./erc20.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC"}

package/dist/src/index.js

@@ -1 +1,2 @@
 export * as exact from "./exact/index.js";
+export * as erc20 from "./erc20.js";