@lynq/crypto 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 hogekai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,62 @@
+import { ToolContext, ToolMiddleware, MCPServer } from '@lynq/lynq';
+
+interface CryptoPaymentOptions {
+    /** Middleware name. Default: "crypto" */
+    name?: string;
+    /** Token symbol. Default: "USDC" */
+    token?: "USDC" | "USDT" | "DAI" | "ETH" | string;
+    /** Recipient wallet address. */
+    recipient: string;
+    /** Amount in token units. */
+    amount: number;
+    /** Network. Default: "base" */
+    network?: "base" | "base-sepolia" | "ethereum" | "polygon" | "solana" | string;
+    /** Base URL of your server. */
+    baseUrl: string;
+    /** Callback path. Default: "/payment/crypto/callback" */
+    callbackPath?: string;
+    /** Session key for payment data. Default: "payment" */
+    sessionKey?: string;
+    /** If true, only charge once per session per tool. Default: false */
+    once?: boolean;
+    /** Message shown to user. */
+    message?: string;
+    /** Timeout in ms. Default: 300000 */
+    timeout?: number;
+    /** Custom skip condition. Takes priority over sessionKey check. */
+    skipIf?: (c: ToolContext) => boolean | Promise<boolean>;
+    /** Called after payment completes successfully, before next(). */
+    onComplete?: (c: ToolContext) => void | Promise<void>;
+}
+/** @deprecated Use `CryptoPaymentOptions` instead. */
+type UsdcPaymentOptions = CryptoPaymentOptions;
+declare function crypto(options: CryptoPaymentOptions): ToolMiddleware;
+/** @deprecated Use `crypto()` from `@lynq/crypto` instead. */
+declare const usdcPayment: typeof crypto;
+interface HandleCallbackOptions {
+    /** RPC URL for the network. */
+    rpcUrl?: string;
+    /** Expected recipient address. */
+    recipient: string;
+    /** Expected amount. */
+    amount: number;
+    /** Session key. Default: "payment" */
+    sessionKey?: string;
+}
+/** @deprecated Use `HandleCallbackOptions` instead. */
+type HandleUsdcCallbackOptions = HandleCallbackOptions;
+/**
+ * Handle crypto payment callback. Call from your HTTP callback route.
+ * Verifies the on-chain transaction, stores in session, and completes elicitation.
+ */
+declare function handleCallback(server: MCPServer, params: {
+    state: string;
+    txHash: string;
+}, options: HandleCallbackOptions): Promise<{
+    success: boolean;
+    error?: string;
+}>;
+/** @deprecated Use `handleCallback()` from `@lynq/crypto` instead. */
+declare const handleUsdcCallback: typeof handleCallback;
+
+export { type CryptoPaymentOptions, type HandleCallbackOptions, type HandleUsdcCallbackOptions, type UsdcPaymentOptions, crypto, handleCallback, handleUsdcCallback, usdcPayment };

package/dist/index.mjs

@@ -0,0 +1,2 @@
+import {payment}from'@lynq/lynq/payment';function g(e){let{recipient:n,amount:t,token:r="USDC",network:a="base",baseUrl:o,callbackPath:s="/payment/crypto/callback",once:p=false}=e,y=e.name??"crypto",m=e.sessionKey??"payment",d=e.message??`Payment required (${t} ${r}).`,i={name:y,sessionKey:m,message:d,buildUrl:({sessionId:c,elicitationId:l})=>{let f=new URLSearchParams({recipient:n,amount:String(t),token:r,network:a,state:`${c}:${l}`});return `${o}${s}?${f}`}};e.timeout!==void 0&&(i.timeout=e.timeout),e.skipIf&&(i.skipIf=e.skipIf),e.onComplete&&(i.onComplete=e.onComplete);let u=payment(i);return p?u:{...u,onResult(c,l){return l.session.set(m,void 0),c}}}var P=g;async function C(e,n,t){let r=t.sessionKey??"payment",[a,o]=n.state.split(":");if(!a||!o)return {success:false,error:"Invalid state parameter"};try{return await h(n.txHash,t)?(e.session(a).set(r,{provider:"crypto",txHash:n.txHash,amount:t.amount,recipient:t.recipient,paidAt:new Date().toISOString()}),e.completeElicitation(o),{success:!0}):{success:!1,error:"Transaction verification failed"}}catch(s){return {success:false,error:s instanceof Error?s.message:String(s)}}}var x=C;async function h(e,n){let t=n.rpcUrl??"https://mainnet.base.org";try{return (await(await fetch(t,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({jsonrpc:"2.0",id:1,method:"eth_getTransactionReceipt",params:[e]})})).json()).result?.status==="0x1"}catch{return  false}}
+export{g as crypto,C as handleCallback,x as handleUsdcCallback,P as usdcPayment};

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@lynq/crypto",
+  "version": "0.1.0",
+  "description": "Crypto payment provider for lynq MCP framework.",
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@lynq/lynq": "^0.8.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.6.0",
+    "vitest": "^2.0.0",
+    "zod": "^3.24.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/hogekai/lynq",
+    "directory": "packages/crypto"
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
+}