@faremeter/payment-solana 0.13.0 → 0.15.0

package/README.md

@@ -0,0 +1,33 @@
+# @faremeter/payment-solana
+
+Solana payment scheme implementations for the x402 protocol, supporting SPL token transfers.
+
+## Installation
+
+```bash
+pnpm install @faremeter/payment-solana
+```
+
+## Features
+
+- SPL token payments (USDC, etc.)
+- Devnet, testnet, and mainnet support
+- Automatic fee payer handling
+- Transaction verification
+- Works with any SPL token
+
+## API Reference
+
+<!-- TSDOC_START -->
+
+<!-- TSDOC_END -->
+
+## Related Packages
+
+- [@faremeter/wallet-solana](https://www.npmjs.com/package/@faremeter/wallet-solana) - Solana 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/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"}
+{"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"}

package/dist/src/index.d.ts

@@ -1,2 +1,3 @@
 export * as exact from "./exact/index.js";
+export * as splToken from "./splToken.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,QAAQ,MAAM,YAAY,CAAC"}

package/dist/src/index.js

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

package/dist/src/splToken.d.ts

@@ -0,0 +1,14 @@
+import type { Rpc } from "@solana/rpc";
+import type { GetTokenAccountBalanceApi } from "@solana/rpc-api";
+import { Base58Address } from "@faremeter/types/solana";
+export interface GetTokenBalanceArgs {
+    asset: Base58Address;
+    account: Base58Address;
+    rpcClient: Rpc<GetTokenAccountBalanceApi>;
+}
+export declare function isAccountNotFoundError(e: unknown): boolean;
+export declare function getTokenBalance(args: GetTokenBalanceArgs): Promise<{
+    amount: bigint;
+    decimals: number;
+} | null>;
+//# sourceMappingURL=splToken.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"splToken.d.ts","sourceRoot":"","sources":["../../src/splToken.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAEjE,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAMxD,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,aAAa,CAAC;IACrB,OAAO,EAAE,aAAa,CAAC;IACvB,SAAS,EAAE,GAAG,CAAC,yBAAyB,CAAC,CAAC;CAC3C;AAGD,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,OAAO,WAkBhD;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,mBAAmB;;;UA4B9D"}

package/dist/src/splToken.js

@@ -0,0 +1,42 @@
+import { address } from "@solana/addresses";
+import { Base58Address } from "@faremeter/types/solana";
+import { findAssociatedTokenPda, TOKEN_PROGRAM_ADDRESS, } from "@solana-program/token";
+// XXX - There has got to be a better way to do this.
+export function isAccountNotFoundError(e) {
+    if (!e || !(e instanceof Error)) {
+        return false;
+    }
+    if ("name" in e &&
+        (e.name === "TokenAccountNotFoundError" ||
+            e.name === "AccountNotFoundError")) {
+        return true;
+    }
+    if ("message" in e && e.message.includes("could not find account")) {
+        return true;
+    }
+    return false;
+}
+export async function getTokenBalance(args) {
+    const { asset, account, rpcClient } = args;
+    const owner = address(account);
+    const mint = address(asset);
+    const [ata] = await findAssociatedTokenPda({
+        mint,
+        owner,
+        tokenProgram: TOKEN_PROGRAM_ADDRESS,
+    });
+    let balanceInfo;
+    try {
+        balanceInfo = await rpcClient.getTokenAccountBalance(ata).send();
+    }
+    catch (e) {
+        if (isAccountNotFoundError(e)) {
+            return null;
+        }
+        throw e;
+    }
+    return {
+        amount: BigInt(balanceInfo.value.amount),
+        decimals: balanceInfo.value.decimals,
+    };
+}