@pakt/psilo 0.0.1 → 0.0.3

package/README.md

@@ -1,8 +1,8 @@
 # PsiloSDK
 
-PsiloSDK is the official TypeScript SDK for interacting computationally with Pakt's production-ready EVM single-use, non-custodial, MPC-protected escrow wallets via the Model Context Protocol (MCP) compatible backend.
+PsiloSDK is the official TypeScript SDK for interacting with Pakt's production-ready EVM escrow service. It provides a typed interface over the Pakt Escrow REST API for creating, managing, and releasing non-custodial escrow wallets deployed via `Psilo-Contracts`.
 
-It is designed to be fully AI-native and provide seamless interoperability for creating, managing, and releasing Escrow objects that leverage Pakt's `Psilo-Contracts`.
+Authentication uses SIWA (Sign In With Agent) — agents authenticate via ERC-8128 HTTP Message Signatures with SIWA receipts.
 
 ## Installation
 
@@ -14,94 +14,131 @@ yarn add @pakt/psilo-sdk
 
 ## Setup & Initialization
 
-You must initialize the SDK by pointing it to the deployed MCP-compatible endpoint hosting the Psilo backend server.
+Initialise the PsiloSDK like so:
+
+Development baseUrl: `https://devescrow.psiloai.com`
+
+Production baseUrl: `https://escrow.psiloai.com`
 
 ```typescript
 import { PsiloSDK } from "@pakt/psilo-sdk";
 
 const sdk = await PsiloSDK.init({
-  baseUrl: "http://localhost:3000", // Example backend or MCP deployment URL
-  verbose: true // Optional logging
+  baseUrl: "https://devescrow.psiloai.com", //for development
+  verbose: true // optional logging
 });
 ```
 
-## Features: Escrow Management
+## Escrow Lifecycle
+
+The escrow flow has four phases:
+
+1. **Create** — server deploys the escrow contract and returns the address plus unsigned deposit transaction
+2. **Deposit** — buyer signs and broadcasts the deposit transaction client-side
+3. **Mark ready** — seller and buyer each call `updateStatus` to signal readiness; returns an unsigned transaction for each party to sign and send
+4. **Release** — system triggers `release` once both parties have marked ready
 
-The SDK maps all features designed within the `Psilo-Contracts/MCP_INTEGRATION.md`.
+---
 
-### 1. Compute Address
-Compute an expected escrow address deterministically before deploying it.
+## API Reference
+
+### Chains & Assets
+
+Discover supported networks and tokens before creating an escrow.
 
 ```typescript
-const computed = await sdk.escrow.computeAddress({
-  sender: "0xSenderAddress...",
-  receiver: "0xReceiverAddress...",
-  asset: "0x0000000000000000000000000000000000000000", // ETH
-  amount: "1000000000000000000",
-  originator: "0xOriginator...",
-  salt: "0x123..."
-});
-console.log("Predicted address:", computed.data.predictedAddress);
+// List all supported chains
+const { data } = await sdk.escrow.getChains();
+// data.chains: Array<{ chainId, name, network, nativeCurrency }>
+
+// List supported assets for a chain
+const { data } = await sdk.escrow.getAssets("43113");
+// data.assets: Array<{ address, symbol, name, decimals, isNative }>
 ```
 
-### 2. Create Escrow
-Create a new escrow on the blockchain.
+---
+
+### 1. Create Escrow
+
+The server calls `EscrowFactory.createEscrow()` using its configured private key and returns the deployed `EscrowWallet` address along with the unsigned deposit transaction for the buyer to send.
 
 ```typescript
-const escrowResponse = await sdk.escrow.create({
-  sender: "0xSenderAddress...",
-  receiver: "0xReceiverAddress...",
-  asset: "0x0000000000000000000000000000000000000000",
-  amount: "1000000000000000000",
-  originator: "0xOriginator...",
-  salt: "0xSomeDeterministicSalt...",
-  metadataHash: "0xOptionalMetadata..."
+const { data } = await sdk.escrow.create({
+  chainId: "43113",                                         // EIP-155 chain ID
+  buyer: "0xBuyerAddress...",
+  seller: "0xSellerAddress...",
+  title: "Website redesign",
+  description: "Full redesign of landing page",            // optional
+  amount: "100",                                           // in token units
+  asset: "0x5425890298aed601595a70AB815c96711a31Bc65",    // token contract address
+  expiration: "1735689600",                                // unix timestamp, optional
+  releaseType: "0"                                         // 0–255, optional
 });
-const escrowAddress = escrowResponse.data.escrowAddress;
+
+const { escrowAddress, approve, deposit } = data.onChain;
+// If asset requires allowance: sign and send `approve` tx first
+// Then sign and send `deposit` tx to fund the escrow
 ```
 
-### 3. Deposit
-Fund a created escrow.
+**Response fields:**
+
+| Field | Description |
+|---|---|
+| `onChain.escrowAddress` | Deployed escrow contract address |
+| `onChain.approve` | ERC-20 approve tx to sign/send (null for native tokens) |
+| `onChain.deposit` | Deposit tx to sign/send |
+| `onChain.txHash` | Factory deployment tx hash |
+| `buyerWallet` / `sellerWallet` / `arbiterWallet` | Party addresses |
+
+---
+
+### 2. Query Status
 
 ```typescript
-await sdk.escrow.deposit(escrowAddress, {
-  from: "0xSenderAddress..."
-});
+const { data } = await sdk.escrow.getStatus("43113", "0xEscrowAddress...");
+
+console.log(data.deposited);        // buyer has funded the escrow
+console.log(data.readyForRelease);  // seller has marked ready
+console.log(data.buyerReleaseReady); // buyer has marked ready
+console.log(data.balance);          // current balance (wei / smallest unit)
 ```
 
-### 4. Status and Listing
-Query statuses and lists of active escrows.
+**Response fields:** `chainId`, `escrow`, `buyer`, `seller`, `arbiter`, `deposited`, `released`, `readyForRelease`, `buyerReleaseReady`, `balance`
+
+---
+
+### 3. Mark Ready (Seller & Buyer)
+
+Both parties must signal readiness before the escrow can be released. `updateStatus` checks the provided address against the escrow contract and returns the appropriate unsigned transaction:
+
+- **Seller address** → `markReady` transaction
+- **Buyer address** → `markBuyerEscrowReleaseReady` transaction
 
 ```typescript
-// Query one
-const status = await sdk.escrow.getStatus(escrowAddress);
-console.log("Status:", status.data.deposited, status.data.released);
-
-// Query all
-const escrows = await sdk.escrow.list({
-    sender: "0xSenderAddress...",
-    status: "deposited"
+const { data } = await sdk.escrow.updateStatus({
+  chainId: "43113",
+  escrow: "0xEscrowAddress...",
+  address: "0xSellerOrBuyerAddress..."
 });
+
+// data is a PrepareTransactionResponse — sign and broadcast it client-side
+// { to, data, value, chainId, gas, maxFeePerGas, maxPriorityFeePerGas, type, nonce, instructions }
 ```
 
-### 5. Multi-Party Approval & Release
-The MPC-shard functionality is exposed through signing a release using 2-of-3 configured authority.
+---
 
-```typescript
-// Ask the sender to sign
-const senderSignature = await sdk.escrow.signRelease(escrowAddress, {
-    signerAddress: "0xSenderAddress...",
-    privateKey: "0x..." // Optional if managed by the MCP server environment
-});
+### 4. Release Escrow
 
-// Ask the receiver to sign
-const receiverSignature = await sdk.escrow.signRelease(escrowAddress, {
-    signerAddress: "0xReceiverAddress..."
-});
+System-only endpoint. The server's arbiter key signs the on-chain release. Requires the `X-Release-Secret` header to be set — this should only be called by your backend/system trigger after confirming both parties have marked ready.
 
-// Release funds
-await sdk.escrow.release(escrowAddress, {
-    signatures: [senderSignature.data.signature, receiverSignature.data.signature],
-    executor: "0xExecutorAddress..."
-});
+```typescript
+const { data } = await sdk.escrow.release(
+  "43113",            // chainId
+  "0xEscrowAddress...",
+  { recipient: "0xSellerAddress..." } // optional, defaults to seller
+);
+
+// data: { success, txHash, escrowAddress, arbiter }
 ```
+
+> **Note:** Call `getStatus` first to confirm `readyForRelease` and `buyerReleaseReady` are both `true` before triggering release.

package/dist/main.d.ts

@@ -51,23 +51,27 @@ declare const parseUrlWithQuery: (url: string, filter: object | any) => string;
 interface EscrowModuleType {
     create(data: CreateEscrowDto): Promise<ResponseDto<CreateEscrowResponse>>;
     getStatus(chainId: string, escrowAddress: string): Promise<ResponseDto<EscrowStatusResponse>>;
-    release(escrowAddress: string, data?: ReleaseDto): Promise<ResponseDto<ReleaseResponse>>;
-    updateStatus(escrowAddress: string, data: UpdateEscrowStatusDto): Promise<ResponseDto<PrepareTransactionResponse>>;
-    prepareRelease(escrowAddress: string, recipient?: string): Promise<ResponseDto<PrepareTransactionResponse>>;
-    list(params?: ListEscrowsParams): Promise<ResponseDto<ListEscrowsResponse>>;
+    release(chainId: string, escrowAddress: string, data?: ReleaseDto): Promise<ResponseDto<ReleaseResponse>>;
+    updateStatus(data: UpdateEscrowStatusDto): Promise<ResponseDto<PrepareTransactionResponse>>;
     getChains(): Promise<ResponseDto<GetEscrowChainsResponseDto>>;
     getAssets(chainId: string): Promise<ResponseDto<GetEscrowAssetsResponseDto>>;
 }
+interface EscrowWebhookConfigDto {
+    webhookUrl: string;
+    webHookType: "a2a" | "json";
+}
 interface CreateEscrowDto {
     chainId: string;
     buyer: string;
     seller: string;
+    creator?: string;
     title: string;
     description?: string;
     amount: string;
     asset: string;
     expiration?: string;
     releaseType?: string;
+    webhookUrls?: EscrowWebhookConfigDto;
 }
 interface CreateEscrowResponse {
     buyerWallet: string;
@@ -95,19 +99,6 @@ interface CreateEscrowResponse {
         };
     };
 }
-interface ComputeAddressParams {
-    sender: string;
-    receiver: string;
-    asset: string;
-    amount: string;
-    originator: string;
-    salt: string;
-    metadataHash?: string;
-}
-interface ComputeAddressResponse {
-    predictedAddress: string;
-    exists: boolean;
-}
 interface EscrowStatusResponse {
     chainId: string;
     escrow: string;
@@ -152,7 +143,8 @@ interface ReleaseResponse {
 interface UpdateEscrowStatusDto {
     chainId: string;
     escrow: string;
-    address: string;
+    address?: string;
+    webhookUrl?: string;
 }
 interface PrepareTransactionResponse {
     to: string;
@@ -168,29 +160,6 @@ interface PrepareTransactionResponse {
     buyer?: string;
     nonce?: string;
 }
-interface ListEscrowsParams {
-    sender?: string;
-    receiver?: string;
-    status?: "pending" | "deposited" | "released";
-    page?: number;
-    limit?: number;
-}
-interface EscrowListItem {
-    address: string;
-    sender: string;
-    receiver: string;
-    asset: string;
-    amount: string;
-    deposited: boolean;
-    released: boolean;
-    createdAt: string;
-}
-interface ListEscrowsResponse {
-    total: number;
-    page: number;
-    limit: number;
-    escrows: EscrowListItem[];
-}
 interface EscrowNativeCurrencyDto {
     name: string;
     symbol: string;
@@ -223,24 +192,61 @@ declare class EscrowService implements EscrowModuleType {
     constructor(id: string);
     create(data: CreateEscrowDto): Promise<ResponseDto<CreateEscrowResponse>>;
     getStatus(chainId: string, escrowAddress: string): Promise<ResponseDto<EscrowStatusResponse>>;
-    updateStatus(escrowAddress: string, data: {
-        chainId: string;
-        address: string;
-    }): Promise<ResponseDto<PrepareTransactionResponse>>;
-    prepareRelease(escrowAddress: string, recipient?: string): Promise<ResponseDto<PrepareTransactionResponse>>;
-    release(escrowAddress: string, data?: {
-        recipient?: string;
-    }): Promise<ResponseDto<ReleaseResponse>>;
-    list(params?: ListEscrowsParams): Promise<ResponseDto<ListEscrowsResponse>>;
+    updateStatus(data: UpdateEscrowStatusDto): Promise<ResponseDto<PrepareTransactionResponse>>;
+    release(chainId: string, escrowAddress: string, data?: ReleaseDto): Promise<ResponseDto<ReleaseResponse>>;
     getChains(): Promise<ResponseDto<GetEscrowChainsResponseDto>>;
     getAssets(chainId: string): Promise<ResponseDto<GetEscrowAssetsResponseDto>>;
 }
 
+interface AuthModuleType {
+    register(data: RegisterDto): Promise<ResponseDto<RegisterResponse>>;
+    nonce(data: NonceDto): Promise<ResponseDto<NonceResponse>>;
+    verify(data: VerifyDto): Promise<ResponseDto<VerifyResponse>>;
+}
+interface NonceDto {
+    address: string;
+    agentId: string;
+    agentRegistry?: string;
+}
+interface NonceResponse {
+    nonce: string;
+    [key: string]: unknown;
+}
+interface VerifyDto {
+    message: string;
+    signature: string;
+}
+interface VerifyResponse {
+    token: string;
+    [key: string]: unknown;
+}
+interface RegisterDto {
+    address: string;
+    agentId: string;
+    agentRegistry?: string;
+    chainId?: string;
+    name?: string;
+    webhookUrl?: string;
+}
+interface RegisterResponse {
+    [key: string]: unknown;
+}
+
+declare class AuthService implements AuthModuleType {
+    private id;
+    private connector;
+    constructor(id: string);
+    register(data: RegisterDto): Promise<ResponseDto<RegisterResponse>>;
+    nonce(data: NonceDto): Promise<ResponseDto<NonceResponse>>;
+    verify(data: VerifyDto): Promise<ResponseDto<VerifyResponse>>;
+}
+
 interface PsiloSDKConfig {
-    baseUrl: string;
+    baseUrl?: string;
     verbose?: boolean;
 }
 declare class PsiloSDK {
+    readonly auth: AuthService;
     readonly escrow: EscrowService;
     readonly connector: Connector;
     constructor(id: string);
@@ -255,4 +261,4 @@ declare class SDKError extends Error {
     constructor(message: string, code?: string, details?: any);
 }
 
-export { ComputeAddressParams, ComputeAddressResponse, Connector, CreateEscrowDto, CreateEscrowResponse, DepositDto, DepositResponse, ErrorUtils, EscrowAssetDto, EscrowChainDto, EscrowListItem, EscrowModuleType, EscrowNativeCurrencyDto, EscrowService, EscrowStatusResponse, GetEscrowAssetsResponseDto, GetEscrowChainsResponseDto, IAny, ListEscrowsParams, ListEscrowsResponse, PrepareTransactionResponse, PsiloSDK, PsiloSDKConfig, ReleaseDto, ReleaseResponse, ResponseDto, SDKError, SignReleaseDto, SignReleaseResponse, StandardResponse, Status, UpdateEscrowStatusDto, parseUrlWithQuery };
+export { AuthModuleType, AuthService, Connector, CreateEscrowDto, CreateEscrowResponse, DepositDto, DepositResponse, ErrorUtils, EscrowAssetDto, EscrowChainDto, EscrowModuleType, EscrowNativeCurrencyDto, EscrowService, EscrowStatusResponse, EscrowWebhookConfigDto, GetEscrowAssetsResponseDto, GetEscrowChainsResponseDto, IAny, NonceDto, NonceResponse, PrepareTransactionResponse, PsiloSDK, PsiloSDKConfig, RegisterDto, RegisterResponse, ReleaseDto, ReleaseResponse, ResponseDto, SDKError, SignReleaseDto, SignReleaseResponse, StandardResponse, Status, UpdateEscrowStatusDto, VerifyDto, VerifyResponse, parseUrlWithQuery };

package/dist/main.js

@@ -1,2 +1,2 @@
-var B=Object.create;var d=Object.defineProperty,K=Object.defineProperties,_=Object.getOwnPropertyDescriptor,G=Object.getOwnPropertyDescriptors,V=Object.getOwnPropertyNames,v=Object.getOwnPropertySymbols,X=Object.getPrototypeOf,C=Object.prototype.hasOwnProperty,Y=Object.prototype.propertyIsEnumerable;var j=(r,t,e)=>t in r?d(r,t,{enumerable:!0,configurable:!0,writable:!0,value:e}):r[t]=e,u=(r,t)=>{for(var e in t||(t={}))C.call(t,e)&&j(r,e,t[e]);if(v)for(var e of v(t))Y.call(t,e)&&j(r,e,t[e]);return r},z=(r,t)=>K(r,G(t)),o=(r,t)=>d(r,"name",{value:t,configurable:!0});var Z=(r,t)=>{for(var e in t)d(r,e,{get:t[e],enumerable:!0})},J=(r,t,e,s)=>{if(t&&typeof t=="object"||typeof t=="function")for(let n of V(t))!C.call(r,n)&&n!==e&&d(r,n,{get:()=>t[n],enumerable:!(s=_(t,n))||s.enumerable});return r};var k=(r,t,e)=>(e=r!=null?B(X(r)):{},J(t||!r||!r.__esModule?d(e,"default",{value:r,enumerable:!0}):e,r)),tt=r=>J(d({},"__esModule",{value:!0}),r);var i=(r,t,e)=>(j(r,typeof t!="symbol"?t+"":t,e),e);var it={};Z(it,{Connector:()=>l,ErrorUtils:()=>c,EscrowService:()=>f,PsiloSDK:()=>R,SDKError:()=>m,Status:()=>nt,parseUrlWithQuery:()=>A});module.exports=tt(it);var ce=require("reflect-metadata");var w=require("typedi");var D=k(require("axios"));var F=class F extends Error{constructor(e,s,n){super(e);i(this,"code");i(this,"details");this.name="SDKError",this.code=s,this.details=n}};o(F,"SDKError");var m=F;var S=class S{constructor(t){i(this,"client");this.client=D.default.create({baseURL:t,headers:{"Content-Type":"application/json"}})}setHeader(t,e){this.client.defaults.headers.common[t]=e}removeHeader(t){delete this.client.defaults.headers.common[t]}handleResponse(t){var s,n,a;let e=t.data;if(e&&e.success===!1)throw new m(((s=e.error)==null?void 0:s.message)||"Unknown error",((n=e.error)==null?void 0:n.code)||"API_ERROR",(a=e.error)==null?void 0:a.details);return e}handleError(t){var e,s;if(D.default.isAxiosError(t)){let n=(e=t.response)==null?void 0:e.data;throw n&&n.error?new m(n.error.message||t.message,n.error.code||"REQUEST_ERROR",n.error.details):new m(t.message,t.code,(s=t.response)==null?void 0:s.data)}throw new m(t.message||"An unexpected error occurred","INTERNAL_ERROR")}async get(t,e){try{let s=await this.client.get(t,e);return this.handleResponse(s)}catch(s){this.handleError(s)}}async post(t,e,s){try{let n=await this.client.post(t,e,s);return this.handleResponse(n)}catch(n){this.handleError(n)}}async put(t,e,s){try{let n=await this.client.put(t,e,s);return this.handleResponse(n)}catch(n){this.handleError(n)}}async delete(t,e){try{let s=await this.client.delete(t,e);return this.handleResponse(s)}catch(s){this.handleError(s)}}};o(S,"Connector");var l=S;var E=require("typedi");var et={delayFirstAttempt:!1,jitter:"none",maxDelay:1/0,numOfAttempts:10,retry:()=>!0,startingDelay:100,timeMultiple:2};function P(r){let t=u(u({},et),r);return t.numOfAttempts<1&&(t.numOfAttempts=1),t}o(P,"getSanitizedOptions");function W(r){let t=Math.random()*r;return Math.round(t)}o(W,"fullJitter");function $(r){return r}o($,"noJitter");function q(r){switch(r.jitter){case"full":return W;case"none":default:return $}}o(q,"JitterFactory");var M=class M{constructor(t){i(this,"options");i(this,"attempt",0);this.options=t}apply(){return new Promise(t=>setTimeout(t,this.jitteredDelay))}setAttemptNumber(t){this.attempt=t}get jitteredDelay(){return q(this.options)(this.delay)}get delay(){let t=this.options.startingDelay,e=this.options.timeMultiple,s=this.numOfDelayedAttempts,n=t*Math.pow(e,s);return Math.min(n,this.options.maxDelay)}get numOfDelayedAttempts(){return this.attempt}};o(M,"Delay");var y=M;var T=class T extends y{async apply(){return this.isFirstAttempt?!0:super.apply()}get isFirstAttempt(){return this.attempt===0}get numOfDelayedAttempts(){return this.attempt-1}};o(T,"SkipFirstDelay");var O=T;var U=class U extends y{};o(U,"AlwaysDelay");var b=U;function I(r,t){let e=rt(r);return e.setAttemptNumber(t),e}o(I,"DelayFactory");function rt(r){return r.delayFirstAttempt?new b(r):new O(r)}o(rt,"initDelayClass");async function H(r,t={}){let e=P(t);return await new st(r,e).execute()}o(H,"backOff");var g,st=(g=class{constructor(t,e){i(this,"request");i(this,"options");i(this,"attemptNumber",0);this.request=t,this.options=e}async execute(){for(;!this.attemptLimitReached;)try{return await this.applyDelay(),await this.request()}catch(t){if(this.attemptNumber++,!await this.options.retry(t,this.attemptNumber)||this.attemptLimitReached)throw t}throw new Error("Something went wrong.")}get attemptLimitReached(){return this.attemptNumber>=this.options.numOfAttempts}async applyDelay(){await I(this.options,this.attemptNumber).apply()}},o(g,"BackOff"),g);var nt=function(r){return r.SUCCESS="success",r.ERROR="error",r}({}),c={newTryFail:async r=>{try{let t=await H(async()=>await r(),{startingDelay:50,timeMultiple:10,numOfAttempts:10,maxDelay:3550,delayFirstAttempt:!1});return u({},t)}catch(t){let e=c.toErrorWithMessage(t);return{data:null,status:"error",message:e?e.message:["Internal Server Error"],code:e.code}}},formatErrorMsg:r=>r.replace("attr.",""),toErrorWithMessage:r=>{var t;if(typeof r=="string")try{let e=JSON.parse(r);return e.data instanceof Array&&e.data.length>0?{message:e.data.map(s=>c.formatErrorMsg(s)),code:e.errorCode}:{message:[(t=e.message)!=null?t:r],code:e.errorCode}}catch(e){}if(c.isErrorWithMessage(r))return{message:[r.message]};try{return{message:[JSON.stringify(r,null,2)]}}catch(e){return{message:[String(r)]}}},isErrorWithMessage(r){return typeof r=="object"&&r!==null&&"message"in r&&typeof r.message=="string"}},A=o((r,t)=>{let e="?",s=Object.keys(t||{});return s.length===0?r:(s.map((n,a)=>{let p="&";(n===void 0||n==="undefined"||n===null||n==="null"||n.length===0)&&(e=e),a+1===s.length&&(p=""),e=e+`${n}=${t[n]}${p}`}),r+e)},"parseUrlWithQuery");function ot(r,t,e,s){var n=arguments.length,a=n<3?t:s===null?s=Object.getOwnPropertyDescriptor(t,e):s,p;if(typeof Reflect=="object"&&typeof Reflect.decorate=="function")a=Reflect.decorate(r,t,e,s);else for(var h=r.length-1;h>=0;h--)(p=r[h])&&(a=(n<3?p(a):n>3?p(t,e,a):p(t,e))||a);return n>3&&a&&Object.defineProperty(t,e,a),a}o(ot,"_ts_decorate");function L(r,t){if(typeof Reflect=="object"&&typeof Reflect.metadata=="function")return Reflect.metadata(r,t)}o(L,"_ts_metadata");var N=class N{constructor(t){i(this,"id");i(this,"connector");this.id=t,this.connector=E.Container.of(this.id).get(l)}async create(t){return c.newTryFail(async()=>await this.connector.post("/api/escrow/create",t))}async getStatus(t,e){return c.newTryFail(async()=>{let s=A("/api/escrow/status",{chainId:t,escrow:e});return await this.connector.get(s)})}async updateStatus(t,e){return c.newTryFail(async()=>{let s=z(u({},e),{escrow:t});return await this.connector.post("/api/escrow/update",s)})}async prepareRelease(t,e){return c.newTryFail(async()=>{let s=e?{escrowAddress:t,recipient:e}:{escrowAddress:t};return await this.connector.post("/api/escrow/prepare-release",s)})}async release(t,e){return c.newTryFail(async()=>{let s=u({escrowAddress:t},e||{});return await this.connector.post("/api/escrow/release",s)})}async list(t){return c.newTryFail(async()=>{let e=t?A("/api/escrows",t):"/api/escrows";return await this.connector.get(e)})}async getChains(){return c.newTryFail(async()=>await this.connector.get("/api/escrow/chains"))}async getAssets(t){return c.newTryFail(async()=>await this.connector.get(`/api/escrow/assets/${t}`))}};o(N,"EscrowService");var f=N;f=ot([(0,E.Service)({factory:r=>new f(r.id),transient:!0}),L("design:type",Function),L("design:paramtypes",[String])],f);function at(r,t,e,s){var n=arguments.length,a=n<3?t:s===null?s=Object.getOwnPropertyDescriptor(t,e):s,p;if(typeof Reflect=="object"&&typeof Reflect.decorate=="function")a=Reflect.decorate(r,t,e,s);else for(var h=r.length-1;h>=0;h--)(p=r[h])&&(a=(n<3?p(a):n>3?p(t,e,a):p(t,e))||a);return n>3&&a&&Object.defineProperty(t,e,a),a}o(at,"_ts_decorate");function Q(r,t){if(typeof Reflect=="object"&&typeof Reflect.metadata=="function")return Reflect.metadata(r,t)}o(Q,"_ts_metadata");var x=class x{constructor(t){i(this,"escrow");i(this,"connector");this.connector=w.Container.of(t).get(l),this.escrow=w.Container.of(t).get(f)}static async init(t){if(!t.baseUrl)throw new Error("PsiloSDK initialization requires a valid baseUrl");t.verbose&&console.log(`[PsiloSDK] Initializing SDK pointed to ${t.baseUrl}`);let e=x.generateRandomString(),s=new l(t.baseUrl);return w.Container.of(e).set(l,s),new x(e)}setAuthorizationHeader(t){this.connector.setHeader("Authorization",`Bearer ${t}`)}static generateRandomString(){let t="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789",e="";for(let s=0;s<60;s++)e+=t.charAt(Math.floor(Math.random()*t.length));return e}};o(x,"PsiloSDK");var R=x;R=at([(0,w.Service)({transient:!0}),Q("design:type",Function),Q("design:paramtypes",[String])],R);0&&(module.exports={Connector,ErrorUtils,EscrowService,PsiloSDK,SDKError,Status,parseUrlWithQuery});
+var G=Object.create;var g=Object.defineProperty;var V=Object.getOwnPropertyDescriptor;var X=Object.getOwnPropertyNames,J=Object.getOwnPropertySymbols,Y=Object.getPrototypeOf,P=Object.prototype.hasOwnProperty,Z=Object.prototype.propertyIsEnumerable;var F=(r,t,e)=>t in r?g(r,t,{enumerable:!0,configurable:!0,writable:!0,value:e}):r[t]=e,d=(r,t)=>{for(var e in t||(t={}))P.call(t,e)&&F(r,e,t[e]);if(J)for(var e of J(t))Z.call(t,e)&&F(r,e,t[e]);return r};var s=(r,t)=>g(r,"name",{value:t,configurable:!0});var k=(r,t)=>{for(var e in t)g(r,e,{get:t[e],enumerable:!0})},W=(r,t,e,n)=>{if(t&&typeof t=="object"||typeof t=="function")for(let o of X(t))!P.call(r,o)&&o!==e&&g(r,o,{get:()=>t[o],enumerable:!(n=V(t,o))||n.enumerable});return r};var tt=(r,t,e)=>(e=r!=null?G(Y(r)):{},W(t||!r||!r.__esModule?g(e,"default",{value:r,enumerable:!0}):e,r)),et=r=>W(g({},"__esModule",{value:!0}),r);var i=(r,t,e)=>(F(r,typeof t!="symbol"?t+"":t,e),e);var pt={};k(pt,{AuthService:()=>h,Connector:()=>u,ErrorUtils:()=>p,EscrowService:()=>m,PsiloSDK:()=>O,SDKError:()=>f,Status:()=>st,parseUrlWithQuery:()=>C});module.exports=et(pt);var xe=require("reflect-metadata");var y=require("typedi");var S=tt(require("axios"));var D=class D extends Error{constructor(e,n,o){super(e);i(this,"code");i(this,"details");this.name="SDKError",this.code=n,this.details=o}};s(D,"SDKError");var f=D;var M=class M{constructor(t){i(this,"client");this.client=S.default.create({baseURL:t,headers:{"Content-Type":"application/json"}})}setHeader(t,e){this.client.defaults.headers.common[t]=e}removeHeader(t){delete this.client.defaults.headers.common[t]}handleResponse(t){var n,o,a;let e=t.data;if(e&&e.success===!1)throw new f(((n=e.error)==null?void 0:n.message)||"Unknown error",((o=e.error)==null?void 0:o.code)||"API_ERROR",(a=e.error)==null?void 0:a.details);return e}handleError(t){var e,n;if(S.default.isAxiosError(t)){let o=(e=t.response)==null?void 0:e.data;throw o&&o.error?new f(o.error.message||t.message,o.error.code||"REQUEST_ERROR",o.error.details):new f(t.message,t.code,(n=t.response)==null?void 0:n.data)}throw new f(t.message||"An unexpected error occurred","INTERNAL_ERROR")}async get(t,e){try{let n=await this.client.get(t,e);return this.handleResponse(n)}catch(n){this.handleError(n)}}async post(t,e,n){try{let o=await this.client.post(t,e,n);return this.handleResponse(o)}catch(o){this.handleError(o)}}async put(t,e,n){try{let o=await this.client.put(t,e,n);return this.handleResponse(o)}catch(o){this.handleError(o)}}async delete(t,e){try{let n=await this.client.delete(t,e);return this.handleResponse(n)}catch(n){this.handleError(n)}}};s(M,"Connector");var u=M;var A=require("typedi");var rt={delayFirstAttempt:!1,jitter:"none",maxDelay:1/0,numOfAttempts:10,retry:()=>!0,startingDelay:100,timeMultiple:2};function $(r){let t=d(d({},rt),r);return t.numOfAttempts<1&&(t.numOfAttempts=1),t}s($,"getSanitizedOptions");function q(r){let t=Math.random()*r;return Math.round(t)}s(q,"fullJitter");function I(r){return r}s(I,"noJitter");function H(r){switch(r.jitter){case"full":return q;case"none":default:return I}}s(H,"JitterFactory");var v=class v{constructor(t){i(this,"options");i(this,"attempt",0);this.options=t}apply(){return new Promise(t=>setTimeout(t,this.jitteredDelay))}setAttemptNumber(t){this.attempt=t}get jitteredDelay(){return H(this.options)(this.delay)}get delay(){let t=this.options.startingDelay,e=this.options.timeMultiple,n=this.numOfDelayedAttempts,o=t*Math.pow(e,n);return Math.min(o,this.options.maxDelay)}get numOfDelayedAttempts(){return this.attempt}};s(v,"Delay");var w=v;var T=class T extends w{async apply(){return this.isFirstAttempt?!0:super.apply()}get isFirstAttempt(){return this.attempt===0}get numOfDelayedAttempts(){return this.attempt-1}};s(T,"SkipFirstDelay");var b=T;var U=class U extends w{};s(U,"AlwaysDelay");var j=U;function L(r,t){let e=nt(r);return e.setAttemptNumber(t),e}s(L,"DelayFactory");function nt(r){return r.delayFirstAttempt?new j(r):new b(r)}s(nt,"initDelayClass");async function _(r,t={}){let e=$(t);return await new ot(r,e).execute()}s(_,"backOff");var x,ot=(x=class{constructor(t,e){i(this,"request");i(this,"options");i(this,"attemptNumber",0);this.request=t,this.options=e}async execute(){for(;!this.attemptLimitReached;)try{return await this.applyDelay(),await this.request()}catch(t){if(this.attemptNumber++,!await this.options.retry(t,this.attemptNumber)||this.attemptLimitReached)throw t}throw new Error("Something went wrong.")}get attemptLimitReached(){return this.attemptNumber>=this.options.numOfAttempts}async applyDelay(){await L(this.options,this.attemptNumber).apply()}},s(x,"BackOff"),x);var st=function(r){return r.SUCCESS="success",r.ERROR="error",r}({}),p={newTryFail:async r=>{try{let t=await _(async()=>await r(),{startingDelay:50,timeMultiple:10,numOfAttempts:10,maxDelay:3550,delayFirstAttempt:!1});return d({},t)}catch(t){let e=p.toErrorWithMessage(t);return{data:null,status:"error",message:e?e.message:["Internal Server Error"],code:e.code}}},formatErrorMsg:r=>r.replace("attr.",""),toErrorWithMessage:r=>{var t;if(typeof r=="string")try{let e=JSON.parse(r);return e.data instanceof Array&&e.data.length>0?{message:e.data.map(n=>p.formatErrorMsg(n)),code:e.errorCode}:{message:[(t=e.message)!=null?t:r],code:e.errorCode}}catch(e){}if(p.isErrorWithMessage(r))return{message:[r.message]};try{return{message:[JSON.stringify(r,null,2)]}}catch(e){return{message:[String(r)]}}},isErrorWithMessage(r){return typeof r=="object"&&r!==null&&"message"in r&&typeof r.message=="string"}},C=s((r,t)=>{let e="?",n=Object.keys(t||{});return n.length===0?r:(n.map((o,a)=>{let c="&";(o===void 0||o==="undefined"||o===null||o==="null"||o.length===0)&&(e=e),a+1===n.length&&(c=""),e=e+`${o}=${t[o]}${c}`}),r+e)},"parseUrlWithQuery");function at(r,t,e,n){var o=arguments.length,a=o<3?t:n===null?n=Object.getOwnPropertyDescriptor(t,e):n,c;if(typeof Reflect=="object"&&typeof Reflect.decorate=="function")a=Reflect.decorate(r,t,e,n);else for(var l=r.length-1;l>=0;l--)(c=r[l])&&(a=(o<3?c(a):o>3?c(t,e,a):c(t,e))||a);return o>3&&a&&Object.defineProperty(t,e,a),a}s(at,"_ts_decorate");function Q(r,t){if(typeof Reflect=="object"&&typeof Reflect.metadata=="function")return Reflect.metadata(r,t)}s(Q,"_ts_metadata");var N=class N{constructor(t){i(this,"id");i(this,"connector");this.id=t,this.connector=A.Container.of(this.id).get(u)}async create(t){return p.newTryFail(async()=>await this.connector.post("/api/escrow/create",t))}async getStatus(t,e){return p.newTryFail(async()=>{let n=C("/api/escrow/status",{chainId:t,escrow:e});return await this.connector.get(n)})}async updateStatus(t){return p.newTryFail(async()=>await this.connector.post("/api/escrow/update",t))}async release(t,e,n){return p.newTryFail(async()=>{let o=d({chainId:t,escrowAddress:e},n||{});return await this.connector.post("/api/escrow/release",o)})}async getChains(){return p.newTryFail(async()=>await this.connector.get("/api/escrow/chains"))}async getAssets(t){return p.newTryFail(async()=>await this.connector.get(`/api/escrow/assets/${t}`))}};s(N,"EscrowService");var m=N;m=at([(0,A.Service)({factory:r=>new m(r.id),transient:!0}),Q("design:type",Function),Q("design:paramtypes",[String])],m);var E=require("typedi");function it(r,t,e,n){var o=arguments.length,a=o<3?t:n===null?n=Object.getOwnPropertyDescriptor(t,e):n,c;if(typeof Reflect=="object"&&typeof Reflect.decorate=="function")a=Reflect.decorate(r,t,e,n);else for(var l=r.length-1;l>=0;l--)(c=r[l])&&(a=(o<3?c(a):o>3?c(t,e,a):c(t,e))||a);return o>3&&a&&Object.defineProperty(t,e,a),a}s(it,"_ts_decorate");function B(r,t){if(typeof Reflect=="object"&&typeof Reflect.metadata=="function")return Reflect.metadata(r,t)}s(B,"_ts_metadata");var z=class z{constructor(t){i(this,"id");i(this,"connector");this.id=t,this.connector=E.Container.of(this.id).get(u)}async register(t){return p.newTryFail(async()=>await this.connector.post("/api/auth/register",t))}async nonce(t){return p.newTryFail(async()=>await this.connector.post("/api/auth/nonce",t))}async verify(t){return p.newTryFail(async()=>await this.connector.post("/api/auth/verify",t))}};s(z,"AuthService");var h=z;h=it([(0,E.Service)({factory:r=>new h(r.id),transient:!0}),B("design:type",Function),B("design:paramtypes",[String])],h);function ct(r,t,e,n){var o=arguments.length,a=o<3?t:n===null?n=Object.getOwnPropertyDescriptor(t,e):n,c;if(typeof Reflect=="object"&&typeof Reflect.decorate=="function")a=Reflect.decorate(r,t,e,n);else for(var l=r.length-1;l>=0;l--)(c=r[l])&&(a=(o<3?c(a):o>3?c(t,e,a):c(t,e))||a);return o>3&&a&&Object.defineProperty(t,e,a),a}s(ct,"_ts_decorate");function K(r,t){if(typeof Reflect=="object"&&typeof Reflect.metadata=="function")return Reflect.metadata(r,t)}s(K,"_ts_metadata");var R=class R{constructor(t){i(this,"auth");i(this,"escrow");i(this,"connector");this.connector=y.Container.of(t).get(u),this.auth=y.Container.of(t).get(h),this.escrow=y.Container.of(t).get(m)}static async init(t){if(!t.baseUrl)throw new Error("PsiloSDK initialization requires a valid baseUrl");t.verbose&&console.log(`[PsiloSDK] Initializing SDK pointed to ${t.baseUrl}`);let e=R.generateRandomString(),n=new u(t.baseUrl);return y.Container.of(e).set(u,n),new R(e)}setAuthorizationHeader(t){this.connector.setHeader("Authorization",`Bearer ${t}`)}static generateRandomString(){let t="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789",e="";for(let n=0;n<60;n++)e+=t.charAt(Math.floor(Math.random()*t.length));return e}};s(R,"PsiloSDK");var O=R;O=ct([(0,y.Service)({transient:!0}),K("design:type",Function),K("design:paramtypes",[String])],O);0&&(module.exports={AuthService,Connector,ErrorUtils,EscrowService,PsiloSDK,SDKError,Status,parseUrlWithQuery});
 //# sourceMappingURL=main.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pakt/psilo",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "description": "SDK for interacting with Pakt Psilo Escrow Contracts via MCP",
   "files": [
     "./dist/main.js",