@piprail/sdk 1.0.0

package/dist/solana-7PZG3CDO.js

@@ -0,0 +1,342 @@
+import {
+  ConfirmationTimeoutError,
+  UnknownTokenError,
+  WrongFamilyError,
+  nativeCost,
+  rejectForeignToken,
+  toInsufficientFundsError
+} from "./chunk-3TQJJ4SQ.js";
+
+// src/drivers/solana/index.ts
+import { Connection, PublicKey as PublicKey2 } from "@solana/web3.js";
+
+// src/drivers/solana/chains.ts
+var SOL_DECIMALS = 9;
+var SOLANA_MAINNET = {
+  caip2: "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
+  defaultRpc: "https://api.mainnet-beta.solana.com",
+  tokens: {
+    USDC: {
+      mint: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
+      decimals: 6,
+      symbol: "USDC"
+    },
+    USDT: {
+      mint: "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB",
+      decimals: 6,
+      symbol: "USDT"
+    }
+  }
+};
+
+// src/drivers/solana/pay.ts
+import {
+  PublicKey,
+  SystemProgram,
+  Transaction
+} from "@solana/web3.js";
+import {
+  createAssociatedTokenAccountIdempotentInstruction,
+  createTransferCheckedInstruction,
+  getAssociatedTokenAddressSync
+} from "@solana/spl-token";
+async function paySolana(params) {
+  const { connection, keypair, accept } = params;
+  const payTo = new PublicKey(accept.payTo);
+  const amount = BigInt(accept.amount);
+  const tx = new Transaction();
+  if (accept.asset === "native") {
+    tx.add(
+      SystemProgram.transfer({
+        fromPubkey: keypair.publicKey,
+        toPubkey: payTo,
+        lamports: amount
+      })
+    );
+  } else {
+    const mint = new PublicKey(accept.asset);
+    const source = getAssociatedTokenAddressSync(mint, keypair.publicKey);
+    const dest = getAssociatedTokenAddressSync(mint, payTo);
+    tx.add(
+      createAssociatedTokenAccountIdempotentInstruction(
+        keypair.publicKey,
+        // payer for any rent
+        dest,
+        payTo,
+        mint
+      )
+    );
+    tx.add(
+      createTransferCheckedInstruction(
+        source,
+        mint,
+        dest,
+        keypair.publicKey,
+        amount,
+        accept.extra.decimals
+      )
+    );
+  }
+  const { blockhash, lastValidBlockHeight } = await connection.getLatestBlockhash();
+  tx.recentBlockhash = blockhash;
+  tx.lastValidBlockHeight = lastValidBlockHeight;
+  tx.feePayer = keypair.publicKey;
+  tx.sign(keypair);
+  const signature = await connection.sendRawTransaction(tx.serialize(), {
+    maxRetries: 5
+  });
+  await connection.confirmTransaction(
+    { signature, blockhash, lastValidBlockHeight },
+    "confirmed"
+  );
+  return signature;
+}
+
+// src/drivers/solana/verify.ts
+async function verifySolana(params) {
+  const { connection, signature, accept } = params;
+  const required = BigInt(accept.amount);
+  let tx;
+  try {
+    tx = await connection.getParsedTransaction(signature, {
+      commitment: "confirmed",
+      maxSupportedTransactionVersion: 0
+    });
+  } catch {
+    return notFound(signature);
+  }
+  if (!tx) return notFound(signature);
+  const meta = tx.meta;
+  if (!meta) {
+    return { ok: false, error: "no_meta", detail: `No metadata for ${signature}.` };
+  }
+  if (meta.err !== null) {
+    return {
+      ok: false,
+      error: "tx_reverted",
+      detail: `Transaction ${signature} failed on-chain.`
+    };
+  }
+  if (typeof tx.blockTime !== "number") {
+    return {
+      ok: false,
+      error: "payment_expired",
+      detail: `Cannot determine the age of ${signature} (no blockTime).`
+    };
+  }
+  const ageSeconds = Math.floor(Date.now() / 1e3) - tx.blockTime;
+  if (ageSeconds > accept.maxTimeoutSeconds) {
+    return {
+      ok: false,
+      error: "payment_expired",
+      detail: `Payment is ${ageSeconds}s old; max allowed is ${accept.maxTimeoutSeconds}s.`
+    };
+  }
+  const accountKeys = tx.transaction.message.accountKeys.map(
+    (k) => k.pubkey.toBase58()
+  );
+  const payer = accountKeys[0] ?? "";
+  if (accept.asset === "native") {
+    const idx = accountKeys.indexOf(accept.payTo);
+    if (idx < 0) {
+      return {
+        ok: false,
+        error: "wrong_recipient",
+        detail: `Native payment in ${signature} did not credit ${accept.payTo}.`
+      };
+    }
+    const delta = BigInt(meta.postBalances[idx] ?? 0) - BigInt(meta.preBalances[idx] ?? 0);
+    if (delta < required) {
+      return {
+        ok: false,
+        error: "amount_too_low",
+        detail: `Credited ${delta} lamports, required ${required}.`
+      };
+    }
+  } else {
+    const mint = accept.asset;
+    const pre = meta.preTokenBalances ?? [];
+    const post = meta.postTokenBalances ?? [];
+    let delta = 0n;
+    for (const p of post) {
+      if (p.mint !== mint || p.owner !== accept.payTo) continue;
+      const before = pre.find((x) => x.accountIndex === p.accountIndex);
+      delta += BigInt(p.uiTokenAmount.amount) - BigInt(before?.uiTokenAmount.amount ?? "0");
+    }
+    if (delta < required) {
+      return {
+        ok: false,
+        error: "transfer_not_found",
+        detail: `No SPL transfer of >= ${required} (mint ${mint}) to ${accept.payTo} in ${signature}.`
+      };
+    }
+  }
+  return {
+    ok: true,
+    receipt: {
+      scheme: "onchain-proof",
+      success: true,
+      network: accept.network,
+      transaction: signature,
+      asset: accept.asset,
+      amount: accept.amount,
+      payer,
+      payTo: accept.payTo,
+      verifiedAt: (/* @__PURE__ */ new Date()).toISOString()
+    }
+  };
+}
+function notFound(signature) {
+  return {
+    ok: false,
+    error: "tx_not_found",
+    detail: `Signature ${signature} not found or not yet confirmed.`
+  };
+}
+
+// src/drivers/solana/wallet.ts
+import { Keypair as Keypair2 } from "@solana/web3.js";
+import bs58 from "bs58";
+function toKeypair(wallet, network) {
+  if (typeof wallet !== "object" || wallet === null) {
+    throw new WrongFamilyError(
+      `chain ${network} is Solana; wallet must be { secretKey } or { signer }.`
+    );
+  }
+  if ("privateKey" in wallet || "walletClient" in wallet) {
+    throw new WrongFamilyError(
+      `chain ${network} is Solana; an EVM wallet can't be used \u2014 pass { secretKey } or { signer }.`
+    );
+  }
+  if ("signer" in wallet) {
+    return wallet.signer;
+  }
+  if ("secretKey" in wallet) {
+    const sk = wallet.secretKey;
+    const bytes = typeof sk === "string" ? bs58.decode(sk) : sk;
+    return Keypair2.fromSecretKey(bytes);
+  }
+  throw new WrongFamilyError(
+    `chain ${network} is Solana; wallet must be { secretKey } or { signer }.`
+  );
+}
+
+// src/drivers/solana/index.ts
+var solanaDriver = {
+  family: "solana",
+  resolve(opts) {
+    if (opts.chain !== "solana") return null;
+    const rpcUrl = opts.rpcUrl ?? SOLANA_MAINNET.defaultRpc;
+    return makeSolanaNetwork(SOLANA_MAINNET, rpcUrl);
+  }
+};
+function makeSolanaNetwork(preset, rpcUrl) {
+  const connection = new Connection(rpcUrl, "confirmed");
+  const network = preset.caip2;
+  return {
+    family: "solana",
+    network,
+    supports: (n) => n === network,
+    resolveToken(token) {
+      if (token === "native") {
+        return { asset: "native", decimals: SOL_DECIMALS, symbol: "SOL" };
+      }
+      if (typeof token === "string") {
+        const info = preset.tokens[token.toUpperCase()];
+        if (!info) {
+          const known = Object.keys(preset.tokens).join(", ") || "(none built in)";
+          throw new UnknownTokenError(
+            `token "${token}" isn't built in for Solana (known: ${known}). Pass { mint, decimals } instead, or use 'native'.`
+          );
+        }
+        return { asset: info.mint, decimals: info.decimals, symbol: info.symbol };
+      }
+      rejectForeignToken(token, "solana", network);
+      if (!("mint" in token)) {
+        throw new WrongFamilyError(
+          `chain ${network} is Solana; a custom token must be { mint, decimals }.`
+        );
+      }
+      return {
+        asset: token.mint,
+        decimals: token.decimals,
+        ...token.symbol ? { symbol: token.symbol } : {}
+      };
+    },
+    describeAsset(asset) {
+      if (asset === "native") return { symbol: "SOL", decimals: SOL_DECIMALS };
+      for (const info of Object.values(preset.tokens)) {
+        if (info.mint === asset) return { symbol: info.symbol, decimals: info.decimals };
+      }
+      return null;
+    },
+    assertValidPayTo(payTo) {
+      if (payTo.startsWith("0x")) {
+        throw new WrongFamilyError(
+          `chain ${network} is Solana, but payTo "${payTo}" looks like an EVM address.`
+        );
+      }
+      try {
+        new PublicKey2(payTo);
+      } catch {
+        throw new WrongFamilyError(
+          `chain ${network} is Solana, but payTo "${payTo}" is not a base58 address.`
+        );
+      }
+    },
+    bindWallet(wallet) {
+      return { _native: toKeypair(wallet, network) };
+    },
+    async send(wallet, accept) {
+      try {
+        return await paySolana({ connection, keypair: wallet._native, accept });
+      } catch (err) {
+        throw toInsufficientFundsError(err) ?? err;
+      }
+    },
+    async confirm(ref) {
+      let info;
+      try {
+        const { value } = await connection.getSignatureStatuses([ref], {
+          searchTransactionHistory: true
+        });
+        info = value[0];
+      } catch (err) {
+        throw new ConfirmationTimeoutError(
+          `Solana payment ${ref} could not be confirmed (RPC read failed).`,
+          { cause: err }
+        );
+      }
+      if (!info || info.err || info.confirmationStatus !== "confirmed" && info.confirmationStatus !== "finalized") {
+        throw new ConfirmationTimeoutError(`Solana payment ${ref} did not confirm in time.`);
+      }
+      return { height: String(info.slot) };
+    },
+    async estimateCost(accept) {
+      const base = 5000n;
+      if (accept.asset === "native") {
+        return nativeCost({
+          symbol: "SOL",
+          decimals: SOL_DECIMALS,
+          fee: base,
+          basis: "heuristic",
+          detail: "1 signature (5000 lamports)"
+        });
+      }
+      const ataRent = 2039280n;
+      return nativeCost({
+        symbol: "SOL",
+        decimals: SOL_DECIMALS,
+        fee: base + ataRent,
+        basis: "heuristic",
+        detail: "1 signature + recipient token-account rent (~0.00204 SOL, if not already created)"
+      });
+    },
+    async verify(ref, accept) {
+      return verifySolana({ connection, signature: ref, accept });
+    }
+  };
+}
+export {
+  solanaDriver
+};

package/dist/solana-F7H4YDW5.cjs

@@ -0,0 +1,342 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; } function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+
+
+
+
+
+
+var _chunkWQWNPAYQcjs = require('./chunk-WQWNPAYQ.cjs');
+
+// src/drivers/solana/index.ts
+var _web3js = require('@solana/web3.js');
+
+// src/drivers/solana/chains.ts
+var SOL_DECIMALS = 9;
+var SOLANA_MAINNET = {
+  caip2: "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
+  defaultRpc: "https://api.mainnet-beta.solana.com",
+  tokens: {
+    USDC: {
+      mint: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
+      decimals: 6,
+      symbol: "USDC"
+    },
+    USDT: {
+      mint: "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB",
+      decimals: 6,
+      symbol: "USDT"
+    }
+  }
+};
+
+// src/drivers/solana/pay.ts
+
+
+
+
+
+
+
+
+
+var _spltoken = require('@solana/spl-token');
+async function paySolana(params) {
+  const { connection, keypair, accept } = params;
+  const payTo = new (0, _web3js.PublicKey)(accept.payTo);
+  const amount = BigInt(accept.amount);
+  const tx = new (0, _web3js.Transaction)();
+  if (accept.asset === "native") {
+    tx.add(
+      _web3js.SystemProgram.transfer({
+        fromPubkey: keypair.publicKey,
+        toPubkey: payTo,
+        lamports: amount
+      })
+    );
+  } else {
+    const mint = new (0, _web3js.PublicKey)(accept.asset);
+    const source = _spltoken.getAssociatedTokenAddressSync.call(void 0, mint, keypair.publicKey);
+    const dest = _spltoken.getAssociatedTokenAddressSync.call(void 0, mint, payTo);
+    tx.add(
+      _spltoken.createAssociatedTokenAccountIdempotentInstruction.call(void 0, 
+        keypair.publicKey,
+        // payer for any rent
+        dest,
+        payTo,
+        mint
+      )
+    );
+    tx.add(
+      _spltoken.createTransferCheckedInstruction.call(void 0, 
+        source,
+        mint,
+        dest,
+        keypair.publicKey,
+        amount,
+        accept.extra.decimals
+      )
+    );
+  }
+  const { blockhash, lastValidBlockHeight } = await connection.getLatestBlockhash();
+  tx.recentBlockhash = blockhash;
+  tx.lastValidBlockHeight = lastValidBlockHeight;
+  tx.feePayer = keypair.publicKey;
+  tx.sign(keypair);
+  const signature = await connection.sendRawTransaction(tx.serialize(), {
+    maxRetries: 5
+  });
+  await connection.confirmTransaction(
+    { signature, blockhash, lastValidBlockHeight },
+    "confirmed"
+  );
+  return signature;
+}
+
+// src/drivers/solana/verify.ts
+async function verifySolana(params) {
+  const { connection, signature, accept } = params;
+  const required = BigInt(accept.amount);
+  let tx;
+  try {
+    tx = await connection.getParsedTransaction(signature, {
+      commitment: "confirmed",
+      maxSupportedTransactionVersion: 0
+    });
+  } catch (e) {
+    return notFound(signature);
+  }
+  if (!tx) return notFound(signature);
+  const meta = tx.meta;
+  if (!meta) {
+    return { ok: false, error: "no_meta", detail: `No metadata for ${signature}.` };
+  }
+  if (meta.err !== null) {
+    return {
+      ok: false,
+      error: "tx_reverted",
+      detail: `Transaction ${signature} failed on-chain.`
+    };
+  }
+  if (typeof tx.blockTime !== "number") {
+    return {
+      ok: false,
+      error: "payment_expired",
+      detail: `Cannot determine the age of ${signature} (no blockTime).`
+    };
+  }
+  const ageSeconds = Math.floor(Date.now() / 1e3) - tx.blockTime;
+  if (ageSeconds > accept.maxTimeoutSeconds) {
+    return {
+      ok: false,
+      error: "payment_expired",
+      detail: `Payment is ${ageSeconds}s old; max allowed is ${accept.maxTimeoutSeconds}s.`
+    };
+  }
+  const accountKeys = tx.transaction.message.accountKeys.map(
+    (k) => k.pubkey.toBase58()
+  );
+  const payer = _nullishCoalesce(accountKeys[0], () => ( ""));
+  if (accept.asset === "native") {
+    const idx = accountKeys.indexOf(accept.payTo);
+    if (idx < 0) {
+      return {
+        ok: false,
+        error: "wrong_recipient",
+        detail: `Native payment in ${signature} did not credit ${accept.payTo}.`
+      };
+    }
+    const delta = BigInt(_nullishCoalesce(meta.postBalances[idx], () => ( 0))) - BigInt(_nullishCoalesce(meta.preBalances[idx], () => ( 0)));
+    if (delta < required) {
+      return {
+        ok: false,
+        error: "amount_too_low",
+        detail: `Credited ${delta} lamports, required ${required}.`
+      };
+    }
+  } else {
+    const mint = accept.asset;
+    const pre = _nullishCoalesce(meta.preTokenBalances, () => ( []));
+    const post = _nullishCoalesce(meta.postTokenBalances, () => ( []));
+    let delta = 0n;
+    for (const p of post) {
+      if (p.mint !== mint || p.owner !== accept.payTo) continue;
+      const before = pre.find((x) => x.accountIndex === p.accountIndex);
+      delta += BigInt(p.uiTokenAmount.amount) - BigInt(_nullishCoalesce(_optionalChain([before, 'optionalAccess', _ => _.uiTokenAmount, 'access', _2 => _2.amount]), () => ( "0")));
+    }
+    if (delta < required) {
+      return {
+        ok: false,
+        error: "transfer_not_found",
+        detail: `No SPL transfer of >= ${required} (mint ${mint}) to ${accept.payTo} in ${signature}.`
+      };
+    }
+  }
+  return {
+    ok: true,
+    receipt: {
+      scheme: "onchain-proof",
+      success: true,
+      network: accept.network,
+      transaction: signature,
+      asset: accept.asset,
+      amount: accept.amount,
+      payer,
+      payTo: accept.payTo,
+      verifiedAt: (/* @__PURE__ */ new Date()).toISOString()
+    }
+  };
+}
+function notFound(signature) {
+  return {
+    ok: false,
+    error: "tx_not_found",
+    detail: `Signature ${signature} not found or not yet confirmed.`
+  };
+}
+
+// src/drivers/solana/wallet.ts
+
+var _bs58 = require('bs58'); var _bs582 = _interopRequireDefault(_bs58);
+function toKeypair(wallet, network) {
+  if (typeof wallet !== "object" || wallet === null) {
+    throw new (0, _chunkWQWNPAYQcjs.WrongFamilyError)(
+      `chain ${network} is Solana; wallet must be { secretKey } or { signer }.`
+    );
+  }
+  if ("privateKey" in wallet || "walletClient" in wallet) {
+    throw new (0, _chunkWQWNPAYQcjs.WrongFamilyError)(
+      `chain ${network} is Solana; an EVM wallet can't be used \u2014 pass { secretKey } or { signer }.`
+    );
+  }
+  if ("signer" in wallet) {
+    return wallet.signer;
+  }
+  if ("secretKey" in wallet) {
+    const sk = wallet.secretKey;
+    const bytes = typeof sk === "string" ? _bs582.default.decode(sk) : sk;
+    return _web3js.Keypair.fromSecretKey(bytes);
+  }
+  throw new (0, _chunkWQWNPAYQcjs.WrongFamilyError)(
+    `chain ${network} is Solana; wallet must be { secretKey } or { signer }.`
+  );
+}
+
+// src/drivers/solana/index.ts
+var solanaDriver = {
+  family: "solana",
+  resolve(opts) {
+    if (opts.chain !== "solana") return null;
+    const rpcUrl = _nullishCoalesce(opts.rpcUrl, () => ( SOLANA_MAINNET.defaultRpc));
+    return makeSolanaNetwork(SOLANA_MAINNET, rpcUrl);
+  }
+};
+function makeSolanaNetwork(preset, rpcUrl) {
+  const connection = new (0, _web3js.Connection)(rpcUrl, "confirmed");
+  const network = preset.caip2;
+  return {
+    family: "solana",
+    network,
+    supports: (n) => n === network,
+    resolveToken(token) {
+      if (token === "native") {
+        return { asset: "native", decimals: SOL_DECIMALS, symbol: "SOL" };
+      }
+      if (typeof token === "string") {
+        const info = preset.tokens[token.toUpperCase()];
+        if (!info) {
+          const known = Object.keys(preset.tokens).join(", ") || "(none built in)";
+          throw new (0, _chunkWQWNPAYQcjs.UnknownTokenError)(
+            `token "${token}" isn't built in for Solana (known: ${known}). Pass { mint, decimals } instead, or use 'native'.`
+          );
+        }
+        return { asset: info.mint, decimals: info.decimals, symbol: info.symbol };
+      }
+      _chunkWQWNPAYQcjs.rejectForeignToken.call(void 0, token, "solana", network);
+      if (!("mint" in token)) {
+        throw new (0, _chunkWQWNPAYQcjs.WrongFamilyError)(
+          `chain ${network} is Solana; a custom token must be { mint, decimals }.`
+        );
+      }
+      return {
+        asset: token.mint,
+        decimals: token.decimals,
+        ...token.symbol ? { symbol: token.symbol } : {}
+      };
+    },
+    describeAsset(asset) {
+      if (asset === "native") return { symbol: "SOL", decimals: SOL_DECIMALS };
+      for (const info of Object.values(preset.tokens)) {
+        if (info.mint === asset) return { symbol: info.symbol, decimals: info.decimals };
+      }
+      return null;
+    },
+    assertValidPayTo(payTo) {
+      if (payTo.startsWith("0x")) {
+        throw new (0, _chunkWQWNPAYQcjs.WrongFamilyError)(
+          `chain ${network} is Solana, but payTo "${payTo}" looks like an EVM address.`
+        );
+      }
+      try {
+        new (0, _web3js.PublicKey)(payTo);
+      } catch (e2) {
+        throw new (0, _chunkWQWNPAYQcjs.WrongFamilyError)(
+          `chain ${network} is Solana, but payTo "${payTo}" is not a base58 address.`
+        );
+      }
+    },
+    bindWallet(wallet) {
+      return { _native: toKeypair(wallet, network) };
+    },
+    async send(wallet, accept) {
+      try {
+        return await paySolana({ connection, keypair: wallet._native, accept });
+      } catch (err) {
+        throw _nullishCoalesce(_chunkWQWNPAYQcjs.toInsufficientFundsError.call(void 0, err), () => ( err));
+      }
+    },
+    async confirm(ref) {
+      let info;
+      try {
+        const { value } = await connection.getSignatureStatuses([ref], {
+          searchTransactionHistory: true
+        });
+        info = value[0];
+      } catch (err) {
+        throw new (0, _chunkWQWNPAYQcjs.ConfirmationTimeoutError)(
+          `Solana payment ${ref} could not be confirmed (RPC read failed).`,
+          { cause: err }
+        );
+      }
+      if (!info || info.err || info.confirmationStatus !== "confirmed" && info.confirmationStatus !== "finalized") {
+        throw new (0, _chunkWQWNPAYQcjs.ConfirmationTimeoutError)(`Solana payment ${ref} did not confirm in time.`);
+      }
+      return { height: String(info.slot) };
+    },
+    async estimateCost(accept) {
+      const base = 5000n;
+      if (accept.asset === "native") {
+        return _chunkWQWNPAYQcjs.nativeCost.call(void 0, {
+          symbol: "SOL",
+          decimals: SOL_DECIMALS,
+          fee: base,
+          basis: "heuristic",
+          detail: "1 signature (5000 lamports)"
+        });
+      }
+      const ataRent = 2039280n;
+      return _chunkWQWNPAYQcjs.nativeCost.call(void 0, {
+        symbol: "SOL",
+        decimals: SOL_DECIMALS,
+        fee: base + ataRent,
+        basis: "heuristic",
+        detail: "1 signature + recipient token-account rent (~0.00204 SOL, if not already created)"
+      });
+    },
+    async verify(ref, accept) {
+      return verifySolana({ connection, signature: ref, accept });
+    }
+  };
+}
+
+
+exports.solanaDriver = solanaDriver;