@tuwaio/payments-sdk 0.0.0-stage → 0.0.1

package/dist/solana.cjs

@@ -0,0 +1 @@
+'use strict';var chunkMJOZIUWN_cjs=require('./chunk-MJOZIUWN.cjs'),kit=require('@solana/kit'),system=require('@solana-program/system'),token=require('@solana-program/token'),orbitCore=require('@tuwaio/sdk/orbit'),orbitSolana=require('@tuwaio/solana-sdk/orbit'),pulsarCore=require('@tuwaio/sdk/pulsar');var I=kit.address("TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb"),S=5000n,W=165n;function y(r){if(r.family!=="solana")throw new Error(`${r.chainId} is not a Solana chain`);return r}function w(r){if(!r.startsWith("solana:"))throw new Error(`${r} is not a Solana chain`);return orbitSolana.getCluster({cluster:r})}var q=/blockhash ?not ?found/i;function Q(r){let s=new Set;for(let d=r;typeof d=="object"&&d!==null&&!s.has(d);){if(s.add(d),kit.isSolanaError(d,kit.SOLANA_ERROR__TRANSACTION_ERROR__BLOCKHASH_NOT_FOUND))return  true;let{message:f,cause:g}=d;if(typeof f=="string"&&q.test(f))return  true;d=g;}return  false}var O=(r,s)=>s?{...r,accounts:[...r.accounts??[],{address:kit.address(s),role:kit.AccountRole.READONLY}]}:r;function ee({rpcUrls:r}={}){let s=e=>orbitSolana.createSolanaClientWithCache({rpcUrlOrMoniker:w(e),rpcUrls:r}).rpc,d=async(e,t)=>{let{value:a}=await s(e).getAccountInfo(t,{encoding:"jsonParsed"}).send();if(!a)throw new Error(`${t} is not a token mint`);if(a.owner===token.TOKEN_PROGRAM_ADDRESS)return token.TOKEN_PROGRAM_ADDRESS;if(a.owner!==I)throw new Error(`${t} is not a token mint`);if(a.data.parsed?.info?.extensions?.find(n=>n.extension==="transferHook")?.state?.programId)throw new chunkMJOZIUWN_cjs.a("unsupported","A token with a transfer hook is paid with the QR code");return I},f=async e=>{let t=kit.address(e.token),a=await d(e.chainId,t),[n]=await token.findAssociatedTokenPda({owner:kit.address(e.to),mint:t,tokenProgram:a});return {mint:t,tokenProgram:a,account:n}},g=async(e,t)=>{let a=BigInt(e.amount);if(e.token==="native"){let o=system.getTransferSolInstruction({source:t,destination:kit.address(e.to),amount:a});return [O(o,e.reference)]}let{mint:n,tokenProgram:i,account:c}=await f(e),[p]=await token.findAssociatedTokenPda({owner:t.address,mint:n,tokenProgram:i}),u=token.getCreateAssociatedTokenIdempotentInstruction({payer:t,ata:c,owner:kit.address(e.to),mint:n,tokenProgram:i}),m=token.getTransferCheckedInstruction({source:p,mint:n,destination:c,authority:t,amount:a,decimals:e.decimals},{programAddress:i});return [u,O(m,e.reference)]};return {family:"solana",getBalance:async({chainId:e,account:t,token:a})=>{let n=s(e);if(a==="native")return (await n.getBalance(kit.address(t)).send()).value;let i=kit.address(a),{value:c}=await n.getTokenAccountsByOwner(kit.address(t),{mint:i},{encoding:"jsonParsed"}).send(),p=await d(e,i),[u]=await token.findAssociatedTokenPda({owner:kit.address(t),mint:i,tokenProgram:p}),m=c.find(o=>o.pubkey===u);return BigInt(m?.account.data.parsed.info.tokenAmount.amount??0)},estimateFee:async({instructions:e})=>{let t=y(e);if(t.token==="native")return {amount:S,decimals:9,symbol:"SOL"};let{account:a}=await f(t),n=s(t.chainId),{value:i}=await n.getAccountInfo(a,{encoding:"base64"}).send(),c=i?0n:await n.getMinimumBalanceForRentExemption(W).send();return {amount:S+c,decimals:9,symbol:"SOL"}},sendTransfer:async({instructions:e,account:t,connection:a})=>{let n=y(e),i=a?.connectedAccount;if(!i||i.address!==t)throw new chunkMJOZIUWN_cjs.a("unsupported","No connected Solana account to sign with");let c;try{c=orbitSolana.createSolanaTransactionSendingSigner(i,w(n.chainId));}catch(o){throw new chunkMJOZIUWN_cjs.a("unsupported","The wallet cannot send this transaction",{cause:o})}let p=await g(n,c),{value:u}=await s(n.chainId).getLatestBlockhash({commitment:"confirmed"}).send(),m=kit.pipe(kit.createTransactionMessage({version:0}),o=>kit.setTransactionMessageFeePayerSigner(c,o),o=>kit.setTransactionMessageLifetimeUsingBlockhash(u,o),o=>kit.appendTransactionMessageInstructions(p,o));try{return kit.getBase58Decoder().decode(await kit.signAndSendTransactionMessageWithSigners(m))}catch(o){throw Q(o)?await s(n.chainId).isBlockhashValid(u.blockhash,{commitment:"confirmed"}).send().then(({value:E})=>E).catch(()=>true)?new chunkMJOZIUWN_cjs.a("wrongNetwork",`The wallet is not on ${n.chainId}`,{cause:o}):new chunkMJOZIUWN_cjs.a("failed","The transaction expired in the wallet",{cause:o}):o}},explorerUrl:({chainId:e,txKey:t})=>orbitSolana.getSolanaExplorerLink(`/tx/${t}`,w(e)),explorerAddressUrl:({chainId:e,address:t})=>orbitSolana.getSolanaExplorerLink(`/address/${t}`,w(e)),pulsarTransaction:({txKey:e,instructions:t,account:a,connectorType:n,title:i,description:c,payload:p})=>{let u=y(t),m=r?.[w(u.chainId)];return {adapter:orbitCore.OrbitAdapter.SOLANA,tracker:pulsarCore.TransactionTracker.Solana,txKey:e,chainId:u.chainId,...m?{rpcUrl:m}:{},from:a,type:"payment",connectorType:n,title:i,description:c,payload:p,pending:true,localTimestamp:Math.floor(Date.now()/1e3),isTrackedModalOpen:false}}}}exports.paymentsSolanaAdapter=ee;

package/dist/solana.d.cts

@@ -0,0 +1,42 @@
+import { SolanaClusterMoniker } from '@tuwaio/solana-sdk/orbit';
+import { PaymentsAdapter } from './index.cjs';
+import '@tuwaio/sdk/pulsar';
+import './checkout-C05-kSiE.cjs';
+import 'zustand/vanilla';
+
+/** Options of {@link paymentsSolanaAdapter}. */
+interface PaymentsSolanaAdapterOptions {
+    /** RPC URLs by cluster (`devnet`, `mainnet`…); the public endpoint of a cluster without one. */
+    rpcUrls?: Partial<Record<SolanaClusterMoniker, string>>;
+}
+/**
+ * The adapter that pays Solana methods of a Nova Payments checkout from the Wallet Standard wallet connected through
+ * Satellite Connect. It reads balances and estimates fees on the network, and sends SOL with a system transfer or a
+ * token with `transferChecked` to the merchant's associated token account (created when missing), in the token's own
+ * program (Token or Token-2022), with the Solana Pay reference key of the quote (a refund has none). A Token-2022
+ * mint with a transfer hook is refused: a Solana Pay wallet pays it with the QR code. A transfer the network refuses
+ * for an unknown blockhash, because the wallet sent it on another cluster (Solana wallets choose their network
+ * themselves), throws `PaymentWalletError` with the kind `wrongNetwork`: nothing was paid. Pass it in `adapters` of
+ * `NovaPaymentsProvider`.
+ *
+ * Side effects: RPC reads (the URLs of `rpcUrls`, else the public endpoints of the clusters); wallet prompts.
+ *
+ * @param options - See {@link PaymentsSolanaAdapterOptions}.
+ * @returns The Solana adapter.
+ *
+ * @example
+ * ```tsx
+ * import { NovaPaymentsProvider } from '@tuwaio/payments-sdk';
+ * import { paymentsSolanaAdapter } from '@tuwaio/payments-sdk/solana';
+ *
+ * const adapters = [paymentsSolanaAdapter({ rpcUrls: { devnet: 'https://api.devnet.solana.com' } })];
+ *
+ * export function Payments({ children }: { children: React.ReactNode }) {
+ *   return <NovaPaymentsProvider adapters={adapters}>{children}</NovaPaymentsProvider>;
+ * }
+ * ```
+ */
+declare function paymentsSolanaAdapter({ rpcUrls }?: PaymentsSolanaAdapterOptions): PaymentsAdapter;
+
+export { paymentsSolanaAdapter };
+export type { PaymentsSolanaAdapterOptions };

package/dist/solana.d.ts

@@ -0,0 +1,42 @@
+import { SolanaClusterMoniker } from '@tuwaio/solana-sdk/orbit';
+import { PaymentsAdapter } from './index.js';
+import '@tuwaio/sdk/pulsar';
+import './checkout-C05-kSiE.js';
+import 'zustand/vanilla';
+
+/** Options of {@link paymentsSolanaAdapter}. */
+interface PaymentsSolanaAdapterOptions {
+    /** RPC URLs by cluster (`devnet`, `mainnet`…); the public endpoint of a cluster without one. */
+    rpcUrls?: Partial<Record<SolanaClusterMoniker, string>>;
+}
+/**
+ * The adapter that pays Solana methods of a Nova Payments checkout from the Wallet Standard wallet connected through
+ * Satellite Connect. It reads balances and estimates fees on the network, and sends SOL with a system transfer or a
+ * token with `transferChecked` to the merchant's associated token account (created when missing), in the token's own
+ * program (Token or Token-2022), with the Solana Pay reference key of the quote (a refund has none). A Token-2022
+ * mint with a transfer hook is refused: a Solana Pay wallet pays it with the QR code. A transfer the network refuses
+ * for an unknown blockhash, because the wallet sent it on another cluster (Solana wallets choose their network
+ * themselves), throws `PaymentWalletError` with the kind `wrongNetwork`: nothing was paid. Pass it in `adapters` of
+ * `NovaPaymentsProvider`.
+ *
+ * Side effects: RPC reads (the URLs of `rpcUrls`, else the public endpoints of the clusters); wallet prompts.
+ *
+ * @param options - See {@link PaymentsSolanaAdapterOptions}.
+ * @returns The Solana adapter.
+ *
+ * @example
+ * ```tsx
+ * import { NovaPaymentsProvider } from '@tuwaio/payments-sdk';
+ * import { paymentsSolanaAdapter } from '@tuwaio/payments-sdk/solana';
+ *
+ * const adapters = [paymentsSolanaAdapter({ rpcUrls: { devnet: 'https://api.devnet.solana.com' } })];
+ *
+ * export function Payments({ children }: { children: React.ReactNode }) {
+ *   return <NovaPaymentsProvider adapters={adapters}>{children}</NovaPaymentsProvider>;
+ * }
+ * ```
+ */
+declare function paymentsSolanaAdapter({ rpcUrls }?: PaymentsSolanaAdapterOptions): PaymentsAdapter;
+
+export { paymentsSolanaAdapter };
+export type { PaymentsSolanaAdapterOptions };

package/dist/solana.js

@@ -0,0 +1 @@
+import {a}from'./chunk-VTOKR3DS.js';import {address,pipe,createTransactionMessage,setTransactionMessageFeePayerSigner,setTransactionMessageLifetimeUsingBlockhash,appendTransactionMessageInstructions,getBase58Decoder,signAndSendTransactionMessageWithSigners,isSolanaError,SOLANA_ERROR__TRANSACTION_ERROR__BLOCKHASH_NOT_FOUND,AccountRole}from'@solana/kit';import {getTransferSolInstruction}from'@solana-program/system';import {findAssociatedTokenPda,TOKEN_PROGRAM_ADDRESS,getCreateAssociatedTokenIdempotentInstruction,getTransferCheckedInstruction}from'@solana-program/token';import {OrbitAdapter}from'@tuwaio/sdk/orbit';import {getSolanaExplorerLink,createSolanaTransactionSendingSigner,createSolanaClientWithCache,getCluster}from'@tuwaio/solana-sdk/orbit';import {TransactionTracker}from'@tuwaio/sdk/pulsar';var I=address("TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb"),S=5000n,W=165n;function y(r){if(r.family!=="solana")throw new Error(`${r.chainId} is not a Solana chain`);return r}function w(r){if(!r.startsWith("solana:"))throw new Error(`${r} is not a Solana chain`);return getCluster({cluster:r})}var q=/blockhash ?not ?found/i;function Q(r){let s=new Set;for(let d=r;typeof d=="object"&&d!==null&&!s.has(d);){if(s.add(d),isSolanaError(d,SOLANA_ERROR__TRANSACTION_ERROR__BLOCKHASH_NOT_FOUND))return  true;let{message:f,cause:g}=d;if(typeof f=="string"&&q.test(f))return  true;d=g;}return  false}var O=(r,s)=>s?{...r,accounts:[...r.accounts??[],{address:address(s),role:AccountRole.READONLY}]}:r;function ee({rpcUrls:r}={}){let s=e=>createSolanaClientWithCache({rpcUrlOrMoniker:w(e),rpcUrls:r}).rpc,d=async(e,t)=>{let{value:a$1}=await s(e).getAccountInfo(t,{encoding:"jsonParsed"}).send();if(!a$1)throw new Error(`${t} is not a token mint`);if(a$1.owner===TOKEN_PROGRAM_ADDRESS)return TOKEN_PROGRAM_ADDRESS;if(a$1.owner!==I)throw new Error(`${t} is not a token mint`);if(a$1.data.parsed?.info?.extensions?.find(n=>n.extension==="transferHook")?.state?.programId)throw new a("unsupported","A token with a transfer hook is paid with the QR code");return I},f=async e=>{let t=address(e.token),a=await d(e.chainId,t),[n]=await findAssociatedTokenPda({owner:address(e.to),mint:t,tokenProgram:a});return {mint:t,tokenProgram:a,account:n}},g=async(e,t)=>{let a=BigInt(e.amount);if(e.token==="native"){let o=getTransferSolInstruction({source:t,destination:address(e.to),amount:a});return [O(o,e.reference)]}let{mint:n,tokenProgram:i,account:c}=await f(e),[p]=await findAssociatedTokenPda({owner:t.address,mint:n,tokenProgram:i}),u=getCreateAssociatedTokenIdempotentInstruction({payer:t,ata:c,owner:address(e.to),mint:n,tokenProgram:i}),m=getTransferCheckedInstruction({source:p,mint:n,destination:c,authority:t,amount:a,decimals:e.decimals},{programAddress:i});return [u,O(m,e.reference)]};return {family:"solana",getBalance:async({chainId:e,account:t,token:a})=>{let n=s(e);if(a==="native")return (await n.getBalance(address(t)).send()).value;let i=address(a),{value:c}=await n.getTokenAccountsByOwner(address(t),{mint:i},{encoding:"jsonParsed"}).send(),p=await d(e,i),[u]=await findAssociatedTokenPda({owner:address(t),mint:i,tokenProgram:p}),m=c.find(o=>o.pubkey===u);return BigInt(m?.account.data.parsed.info.tokenAmount.amount??0)},estimateFee:async({instructions:e})=>{let t=y(e);if(t.token==="native")return {amount:S,decimals:9,symbol:"SOL"};let{account:a}=await f(t),n=s(t.chainId),{value:i}=await n.getAccountInfo(a,{encoding:"base64"}).send(),c=i?0n:await n.getMinimumBalanceForRentExemption(W).send();return {amount:S+c,decimals:9,symbol:"SOL"}},sendTransfer:async({instructions:e,account:t,connection:a$1})=>{let n=y(e),i=a$1?.connectedAccount;if(!i||i.address!==t)throw new a("unsupported","No connected Solana account to sign with");let c;try{c=createSolanaTransactionSendingSigner(i,w(n.chainId));}catch(o){throw new a("unsupported","The wallet cannot send this transaction",{cause:o})}let p=await g(n,c),{value:u}=await s(n.chainId).getLatestBlockhash({commitment:"confirmed"}).send(),m=pipe(createTransactionMessage({version:0}),o=>setTransactionMessageFeePayerSigner(c,o),o=>setTransactionMessageLifetimeUsingBlockhash(u,o),o=>appendTransactionMessageInstructions(p,o));try{return getBase58Decoder().decode(await signAndSendTransactionMessageWithSigners(m))}catch(o){throw Q(o)?await s(n.chainId).isBlockhashValid(u.blockhash,{commitment:"confirmed"}).send().then(({value:E})=>E).catch(()=>true)?new a("wrongNetwork",`The wallet is not on ${n.chainId}`,{cause:o}):new a("failed","The transaction expired in the wallet",{cause:o}):o}},explorerUrl:({chainId:e,txKey:t})=>getSolanaExplorerLink(`/tx/${t}`,w(e)),explorerAddressUrl:({chainId:e,address:t})=>getSolanaExplorerLink(`/address/${t}`,w(e)),pulsarTransaction:({txKey:e,instructions:t,account:a,connectorType:n,title:i,description:c,payload:p})=>{let u=y(t),m=r?.[w(u.chainId)];return {adapter:OrbitAdapter.SOLANA,tracker:TransactionTracker.Solana,txKey:e,chainId:u.chainId,...m?{rpcUrl:m}:{},from:a,type:"payment",connectorType:n,title:i,description:c,payload:p,pending:true,localTimestamp:Math.floor(Date.now()/1e3),isTrackedModalOpen:false}}}}export{ee as paymentsSolanaAdapter};