@xoxno/sdk-js 1.0.224 → 1.0.226

package/dist/sdk/stellar/read/index.cjs

@@ -0,0 +1 @@
+(()=>{"use strict";var e={d:(t,r)=>{for(var n in r)e.o(r,n)&&!e.o(t,n)&&Object.defineProperty(t,n,{enumerable:!0,get:r[n]})},o:(e,t)=>Object.prototype.hasOwnProperty.call(e,t),r:e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})}},t={};e.r(t),e.d(t,{createStellarLendingReadClient:()=>f,lendingAssetsSchema:()=>y,lendingPositionsSchema:()=>m});const r={type:"string"},n={type:"number"},a={type:"boolean"},o={...r,nullable:!0},i={...n,nullable:!0},s={...r,enum:["mainnet","testnet"]},l={...r,enum:["ready","stale","incomplete"]};function d(e){return{type:"object",required:Object.keys(e),properties:e}}const c={sac:r,symbol:r,name:r,decimals:i,logoUrl:o},p=d({valid:a,stale:a,deviation:a,timestamp:i}),u=d({...c,hubId:n,hubName:r,amountRaw:{...o,description:"Integer token base units, never scaled shares."},amount:o,apy:{...i,description:"Fraction: 0.05 means 5%."},priceUsd:i,valueUsd:i,priceStatus:p,indexRay:o,indexedAt:n,indexedLedger:n}),w=d({amountRaw:o,amount:o,usd:i}),h=d({spokeId:n,spokeName:r,ltvBps:n,supplyCapacity:w,borrowCapacity:w,canSupply:a,canBeCollateral:a,canBorrow:a,canOpenAccount:{...a,description:"Spoke admits new accounts; other entry gates still apply."}}),m={type:"array",items:d({accountId:r,nftContract:r,network:s,spokeId:i,spokeName:o,supplied:{type:"array",items:u},borrow:{type:"array",items:u},hasDebt:{...a,nullable:!0,description:"Null when account rows are unavailable."},healthFactor:{...i,description:"Null without debt or when risk inputs are unavailable."},borrowLimitUsd:i,availableBorrowUsd:{...i,description:"Account headroom, before per-market constraints."},netApy:{...i,description:"Net annual yield divided by positive net equity; fraction."},dataStatus:l})},y={type:"array",items:d({...c,hubId:n,hubName:r,network:s,supplyApy:{...i,description:"Fraction: 0.05 means 5%."},borrowApy:{...i,description:"Fraction: 0.05 means 5%."},priceUsd:i,priceStatus:p,spokes:{type:"array",items:h},dataStatus:l,indexedAt:{...n,description:"Pool state timestamp. Capacities are indexed snapshot estimates; prepare/simulate before signing."},indexedLedger:n})};function b(e){if(!e)return;const t=/\s*<([^<>\s]+)>\s*((?:;\s*[\w!#$%&'*+.^`|~-]+\s*=\s*(?:"(?:[^"\\\r\n]|\\.)*"|[\w!#$%&'*+.^`|~:/-]+)\s*)*)(,|$)/gy;let r,n=0;for(;n<e.length;){const a=t.exec(e);if(!a||a[3]&&t.lastIndex===e.length)throw new Error("Invalid pagination Link header");let o=!1,i=!1;for(const e of a[2].matchAll(/;\s*([\w!#$%&'*+.^`|~-]+)\s*=\s*(?:"((?:[^"\\\r\n]|\\.)*)"|([\w!#$%&'*+.^`|~:/-]+))\s*/g))if("rel"===e[1].toLowerCase()){if(i)throw new Error("Duplicate pagination link relation");i=!0,o=(e[2]??e[3]).replace(/\\(.)/g,"$1").toLowerCase().split(/\s+/).includes("next")}if(o){if(void 0!==r)throw new Error("Multiple next pagination links");r=a[1]}n=t.lastIndex}return r}function f(e){const t=new URL(e.baseUrl.trim());if(!["https:","http:"].includes(t.protocol)||t.username||t.password||t.search||t.hash)throw new Error("baseUrl must be an HTTP API root without credentials, query or fragment");t.pathname=`${t.pathname.replace(/\/+$/,"")}/`;const r=e.fetch??globalThis.fetch?.bind(globalThis);if(!r)throw new Error("A fetch implementation is required");async function n(e,n){const a=new URL(`stellar-lending/v1/${e}`,t);let o=a;const i=new Set,s=[];for(;;){if(i.has(o.href))throw new Error("Pagination Link cycle");i.add(o.href);const e=await r(o.href,{signal:n,redirect:"error"});if(e.redirected||e.url&&new URL(e.url).href!==o.href)throw new Error("Stellar lending redirects are not allowed");if(!e.ok)throw new Error(`Stellar lending request failed: HTTP ${e.status}`);const t=await e.json();if(!Array.isArray(t))throw new Error("Stellar lending response must be an array");s.push(...t);const l=b(e.headers.get("Link"));if(!l)break;const d=new URL(l,o);if(d.origin!==a.origin||d.pathname!==a.pathname||d.username||d.password||d.hash)throw new Error("Pagination Link must stay on the same API endpoint");o=d}return s}return{assets:({usage:e,signal:t}={})=>{if(void 0!==e&&"collateral"!==e&&"borrow"!==e)throw new Error("usage must be collateral or borrow");return n("assets"+(e?`?usage=${e}`:""),t)},positions:(e,{signal:t}={})=>{if(!e.trim()||"."===e||".."===e)throw new Error("owner is required");return n(`users/${encodeURIComponent(e)}/positions`,t)}}}module.exports=t})();

package/dist/sdk/stellar/read/index.d.ts

@@ -0,0 +1,4 @@
+/** Dependency-free Stellar lending REST reads and public response contracts. */
+export * from './types.js';
+export * from './schemas.js';
+export * from './client.js';

package/dist/sdk/stellar/read/index.esm.js

@@ -0,0 +1 @@
+const e={type:"string"},t={type:"number"},r={type:"boolean"},n={...e,nullable:!0},a={...t,nullable:!0},o={...e,enum:["mainnet","testnet"]},s={...e,enum:["ready","stale","incomplete"]};function i(e){return{type:"object",required:Object.keys(e),properties:e}}const l={sac:e,symbol:e,name:e,decimals:a,logoUrl:n},p=i({valid:r,stale:r,deviation:r,timestamp:a}),c=i({...l,hubId:t,hubName:e,amountRaw:{...n,description:"Integer token base units, never scaled shares."},amount:n,apy:{...a,description:"Fraction: 0.05 means 5%."},priceUsd:a,valueUsd:a,priceStatus:p,indexRay:n,indexedAt:t,indexedLedger:t}),d=i({amountRaw:n,amount:n,usd:a}),u=i({spokeId:t,spokeName:e,ltvBps:t,supplyCapacity:d,borrowCapacity:d,canSupply:r,canBeCollateral:r,canBorrow:r,canOpenAccount:{...r,description:"Spoke admits new accounts; other entry gates still apply."}}),w={type:"array",items:i({accountId:e,nftContract:e,network:o,spokeId:a,spokeName:n,supplied:{type:"array",items:c},borrow:{type:"array",items:c},hasDebt:{...r,nullable:!0,description:"Null when account rows are unavailable."},healthFactor:{...a,description:"Null without debt or when risk inputs are unavailable."},borrowLimitUsd:a,availableBorrowUsd:{...a,description:"Account headroom, before per-market constraints."},netApy:{...a,description:"Net annual yield divided by positive net equity; fraction."},dataStatus:s})},h={type:"array",items:i({...l,hubId:t,hubName:e,network:o,supplyApy:{...a,description:"Fraction: 0.05 means 5%."},borrowApy:{...a,description:"Fraction: 0.05 means 5%."},priceUsd:a,priceStatus:p,spokes:{type:"array",items:u},dataStatus:s,indexedAt:{...t,description:"Pool state timestamp. Capacities are indexed snapshot estimates; prepare/simulate before signing."},indexedLedger:t})};function m(e){if(!e)return;const t=/\s*<([^<>\s]+)>\s*((?:;\s*[\w!#$%&'*+.^`|~-]+\s*=\s*(?:"(?:[^"\\\r\n]|\\.)*"|[\w!#$%&'*+.^`|~:/-]+)\s*)*)(,|$)/gy;let r,n=0;for(;n<e.length;){const a=t.exec(e);if(!a||a[3]&&t.lastIndex===e.length)throw new Error("Invalid pagination Link header");let o=!1,s=!1;for(const e of a[2].matchAll(/;\s*([\w!#$%&'*+.^`|~-]+)\s*=\s*(?:"((?:[^"\\\r\n]|\\.)*)"|([\w!#$%&'*+.^`|~:/-]+))\s*/g))if("rel"===e[1].toLowerCase()){if(s)throw new Error("Duplicate pagination link relation");s=!0,o=(e[2]??e[3]).replace(/\\(.)/g,"$1").toLowerCase().split(/\s+/).includes("next")}if(o){if(void 0!==r)throw new Error("Multiple next pagination links");r=a[1]}n=t.lastIndex}return r}function y(e){const t=new URL(e.baseUrl.trim());if(!["https:","http:"].includes(t.protocol)||t.username||t.password||t.search||t.hash)throw new Error("baseUrl must be an HTTP API root without credentials, query or fragment");t.pathname=`${t.pathname.replace(/\/+$/,"")}/`;const r=e.fetch??globalThis.fetch?.bind(globalThis);if(!r)throw new Error("A fetch implementation is required");async function n(e,n){const a=new URL(`stellar-lending/v1/${e}`,t);let o=a;const s=new Set,i=[];for(;;){if(s.has(o.href))throw new Error("Pagination Link cycle");s.add(o.href);const e=await r(o.href,{signal:n,redirect:"error"});if(e.redirected||e.url&&new URL(e.url).href!==o.href)throw new Error("Stellar lending redirects are not allowed");if(!e.ok)throw new Error(`Stellar lending request failed: HTTP ${e.status}`);const t=await e.json();if(!Array.isArray(t))throw new Error("Stellar lending response must be an array");i.push(...t);const l=m(e.headers.get("Link"));if(!l)break;const p=new URL(l,o);if(p.origin!==a.origin||p.pathname!==a.pathname||p.username||p.password||p.hash)throw new Error("Pagination Link must stay on the same API endpoint");o=p}return i}return{assets:({usage:e,signal:t}={})=>{if(void 0!==e&&"collateral"!==e&&"borrow"!==e)throw new Error("usage must be collateral or borrow");return n("assets"+(e?`?usage=${e}`:""),t)},positions:(e,{signal:t}={})=>{if(!e.trim()||"."===e||".."===e)throw new Error("owner is required");return n(`users/${encodeURIComponent(e)}/positions`,t)}}}export{y as createStellarLendingReadClient,h as lendingAssetsSchema,w as lendingPositionsSchema};

package/dist/sdk/stellar/read/schemas.d.ts

@@ -0,0 +1,370 @@
+/** OpenAPI response schema for LendingPosition[]. Every property is required; nullable data remains explicit. */
+export declare const lendingPositionsSchema: {
+    type: "array";
+    items: {
+        type: "object";
+        required: string[];
+        properties: {
+            accountId: {
+                type: "string";
+            };
+            nftContract: {
+                type: "string";
+            };
+            network: {
+                enum: string[];
+                type: "string";
+            };
+            spokeId: {
+                nullable: boolean;
+                type: "number";
+            };
+            spokeName: {
+                nullable: boolean;
+                type: "string";
+            };
+            supplied: {
+                type: "array";
+                items: {
+                    type: "object";
+                    required: string[];
+                    properties: {
+                        hubId: {
+                            type: "number";
+                        };
+                        hubName: {
+                            type: "string";
+                        };
+                        amountRaw: {
+                            description: string;
+                            nullable: boolean;
+                            type: "string";
+                        };
+                        amount: {
+                            nullable: boolean;
+                            type: "string";
+                        };
+                        apy: {
+                            description: string;
+                            nullable: boolean;
+                            type: "number";
+                        };
+                        priceUsd: {
+                            nullable: boolean;
+                            type: "number";
+                        };
+                        valueUsd: {
+                            nullable: boolean;
+                            type: "number";
+                        };
+                        priceStatus: {
+                            type: "object";
+                            required: string[];
+                            properties: {
+                                valid: {
+                                    type: "boolean";
+                                };
+                                stale: {
+                                    type: "boolean";
+                                };
+                                deviation: {
+                                    type: "boolean";
+                                };
+                                timestamp: {
+                                    nullable: boolean;
+                                    type: "number";
+                                };
+                            };
+                        };
+                        indexRay: {
+                            nullable: boolean;
+                            type: "string";
+                        };
+                        indexedAt: {
+                            type: "number";
+                        };
+                        indexedLedger: {
+                            type: "number";
+                        };
+                        sac: {
+                            type: "string";
+                        };
+                        symbol: {
+                            type: "string";
+                        };
+                        name: {
+                            type: "string";
+                        };
+                        decimals: {
+                            nullable: boolean;
+                            type: "number";
+                        };
+                        logoUrl: {
+                            nullable: boolean;
+                            type: "string";
+                        };
+                    };
+                };
+            };
+            borrow: {
+                type: "array";
+                items: {
+                    type: "object";
+                    required: string[];
+                    properties: {
+                        hubId: {
+                            type: "number";
+                        };
+                        hubName: {
+                            type: "string";
+                        };
+                        amountRaw: {
+                            description: string;
+                            nullable: boolean;
+                            type: "string";
+                        };
+                        amount: {
+                            nullable: boolean;
+                            type: "string";
+                        };
+                        apy: {
+                            description: string;
+                            nullable: boolean;
+                            type: "number";
+                        };
+                        priceUsd: {
+                            nullable: boolean;
+                            type: "number";
+                        };
+                        valueUsd: {
+                            nullable: boolean;
+                            type: "number";
+                        };
+                        priceStatus: {
+                            type: "object";
+                            required: string[];
+                            properties: {
+                                valid: {
+                                    type: "boolean";
+                                };
+                                stale: {
+                                    type: "boolean";
+                                };
+                                deviation: {
+                                    type: "boolean";
+                                };
+                                timestamp: {
+                                    nullable: boolean;
+                                    type: "number";
+                                };
+                            };
+                        };
+                        indexRay: {
+                            nullable: boolean;
+                            type: "string";
+                        };
+                        indexedAt: {
+                            type: "number";
+                        };
+                        indexedLedger: {
+                            type: "number";
+                        };
+                        sac: {
+                            type: "string";
+                        };
+                        symbol: {
+                            type: "string";
+                        };
+                        name: {
+                            type: "string";
+                        };
+                        decimals: {
+                            nullable: boolean;
+                            type: "number";
+                        };
+                        logoUrl: {
+                            nullable: boolean;
+                            type: "string";
+                        };
+                    };
+                };
+            };
+            hasDebt: {
+                nullable: boolean;
+                description: string;
+                type: "boolean";
+            };
+            healthFactor: {
+                description: string;
+                nullable: boolean;
+                type: "number";
+            };
+            borrowLimitUsd: {
+                nullable: boolean;
+                type: "number";
+            };
+            availableBorrowUsd: {
+                description: string;
+                nullable: boolean;
+                type: "number";
+            };
+            netApy: {
+                description: string;
+                nullable: boolean;
+                type: "number";
+            };
+            dataStatus: {
+                enum: string[];
+                type: "string";
+            };
+        };
+    };
+};
+/** OpenAPI response schema for LendingAsset[]. Capacities are indexed estimates. */
+export declare const lendingAssetsSchema: {
+    type: "array";
+    items: {
+        type: "object";
+        required: string[];
+        properties: {
+            hubId: {
+                type: "number";
+            };
+            hubName: {
+                type: "string";
+            };
+            network: {
+                enum: string[];
+                type: "string";
+            };
+            supplyApy: {
+                description: string;
+                nullable: boolean;
+                type: "number";
+            };
+            borrowApy: {
+                description: string;
+                nullable: boolean;
+                type: "number";
+            };
+            priceUsd: {
+                nullable: boolean;
+                type: "number";
+            };
+            priceStatus: {
+                type: "object";
+                required: string[];
+                properties: {
+                    valid: {
+                        type: "boolean";
+                    };
+                    stale: {
+                        type: "boolean";
+                    };
+                    deviation: {
+                        type: "boolean";
+                    };
+                    timestamp: {
+                        nullable: boolean;
+                        type: "number";
+                    };
+                };
+            };
+            spokes: {
+                type: "array";
+                items: {
+                    type: "object";
+                    required: string[];
+                    properties: {
+                        spokeId: {
+                            type: "number";
+                        };
+                        spokeName: {
+                            type: "string";
+                        };
+                        ltvBps: {
+                            type: "number";
+                        };
+                        supplyCapacity: {
+                            type: "object";
+                            required: string[];
+                            properties: {
+                                amountRaw: {
+                                    nullable: boolean;
+                                    type: "string";
+                                };
+                                amount: {
+                                    nullable: boolean;
+                                    type: "string";
+                                };
+                                usd: {
+                                    nullable: boolean;
+                                    type: "number";
+                                };
+                            };
+                        };
+                        borrowCapacity: {
+                            type: "object";
+                            required: string[];
+                            properties: {
+                                amountRaw: {
+                                    nullable: boolean;
+                                    type: "string";
+                                };
+                                amount: {
+                                    nullable: boolean;
+                                    type: "string";
+                                };
+                                usd: {
+                                    nullable: boolean;
+                                    type: "number";
+                                };
+                            };
+                        };
+                        canSupply: {
+                            type: "boolean";
+                        };
+                        canBeCollateral: {
+                            type: "boolean";
+                        };
+                        canBorrow: {
+                            type: "boolean";
+                        };
+                        canOpenAccount: {
+                            description: string;
+                            type: "boolean";
+                        };
+                    };
+                };
+            };
+            dataStatus: {
+                enum: string[];
+                type: "string";
+            };
+            indexedAt: {
+                description: string;
+                type: "number";
+            };
+            indexedLedger: {
+                type: "number";
+            };
+            sac: {
+                type: "string";
+            };
+            symbol: {
+                type: "string";
+            };
+            name: {
+                type: "string";
+            };
+            decimals: {
+                nullable: boolean;
+                type: "number";
+            };
+            logoUrl: {
+                nullable: boolean;
+                type: "string";
+            };
+        };
+    };
+};

package/dist/sdk/stellar/read/types.d.ts

@@ -0,0 +1,83 @@
+/** Render-ready REST data. Null means unavailable, never an inferred zero. */
+export type LendingAssetUsage = 'collateral' | 'borrow';
+export type LendingDataStatus = 'ready' | 'stale' | 'incomplete';
+export interface LendingToken {
+    sac: string;
+    symbol: string;
+    name: string;
+    decimals: number | null;
+    logoUrl: string | null;
+}
+export interface LendingPriceStatus {
+    valid: boolean;
+    stale: boolean;
+    deviation: boolean;
+    timestamp: number | null;
+}
+export interface PositionAsset extends LendingToken {
+    hubId: number;
+    hubName: string;
+    /** Integer token base units, never scaled shares. */
+    amountRaw: string | null;
+    amount: string | null;
+    /** Fraction: 0.05 means 5%. */
+    apy: number | null;
+    priceUsd: number | null;
+    valueUsd: number | null;
+    priceStatus: LendingPriceStatus;
+    indexRay: string | null;
+    indexedAt: number;
+    indexedLedger: number;
+}
+export interface LendingPosition {
+    accountId: string;
+    nftContract: string;
+    network: 'mainnet' | 'testnet';
+    spokeId: number | null;
+    spokeName: string | null;
+    supplied: PositionAsset[];
+    borrow: PositionAsset[];
+    /** Null when account rows are unavailable. */
+    hasDebt: boolean | null;
+    /** Null without debt or when risk inputs are unavailable. */
+    healthFactor: number | null;
+    borrowLimitUsd: number | null;
+    /** Account headroom, before per-market constraints. */
+    availableBorrowUsd: number | null;
+    /** Net annual yield divided by positive net equity; fraction. */
+    netApy: number | null;
+    dataStatus: LendingDataStatus;
+}
+export interface Capacity {
+    amountRaw: string | null;
+    amount: string | null;
+    usd: number | null;
+}
+export interface AssetSpoke {
+    spokeId: number;
+    spokeName: string;
+    ltvBps: number;
+    supplyCapacity: Capacity;
+    borrowCapacity: Capacity;
+    canSupply: boolean;
+    canBeCollateral: boolean;
+    canBorrow: boolean;
+    /** Spoke admits new accounts; other entry gates still apply. */
+    canOpenAccount: boolean;
+}
+export interface LendingAsset extends LendingToken {
+    hubId: number;
+    hubName: string;
+    network: 'mainnet' | 'testnet';
+    /** Fraction: 0.05 means 5%. */
+    supplyApy: number | null;
+    /** Fraction: 0.05 means 5%. */
+    borrowApy: number | null;
+    priceUsd: number | null;
+    priceStatus: LendingPriceStatus;
+    spokes: AssetSpoke[];
+    dataStatus: LendingDataStatus;
+    /** Pool timestamp. Capacities are indexed estimates; prepare/simulate before signing. */
+    indexedAt: number;
+    indexedLedger: number;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xoxno/sdk-js",
-  "version": "1.0.224",
+  "version": "1.0.226",
   "description": "The SDK to interact with the XOXNO Protocol!",
   "type": "module",
   "exports": {
@@ -24,6 +24,16 @@
         "default": "./dist/sdk/stellar/index.cjs"
       }
     },
+    "./stellar-lending/read": {
+      "import": {
+        "types": "./dist/sdk/stellar/read/index.d.ts",
+        "default": "./dist/sdk/stellar/read/index.esm.js"
+      },
+      "require": {
+        "types": "./dist/cjs/sdk/stellar/read/index.d.ts",
+        "default": "./dist/sdk/stellar/read/index.cjs"
+      }
+    },
     "./stellar-swap": {
       "import": {
         "types": "./dist/sdk/stellar/swap-index.d.ts",
@@ -46,11 +56,11 @@
     "test": "node --experimental-vm-modules node_modules/jest/bin/jest.js",
     "build:sdk": "npx bun run src/sdk/parseSwagger.ts --offline && npx oxlint src/sdk/swagger.ts --fix && npx bun run md/extract.ts",
     "build:types": "tsc --emitDeclarationOnly && node scripts/emit-cjs-dts.mjs",
-    "build:esm": "webpack --config webpack-esm.config.mjs",
+    "build:esm": "swc src -d dist/esm --strip-leading-paths --config-file swc-esm.json -C jsc.baseUrl=$PWD/src && node scripts/emit-esm-entries.mjs && webpack --config webpack-esm.config.mjs",
     "build:cjs": "webpack --config webpack-cjs.config.mjs",
     "build": "npm run build:sdk && npm run build:types && npm run build:esm && npm run build:cjs",
     "verify:dist": "node -e \"const m=require('./dist/index.cjs'); if(typeof m.decodeStellarLendingEvent!=='function')throw new Error('CJS require broken'); console.log('CJS ok')\" && node --input-type=module -e \"import('./dist/index.esm.js').then(m=>{if(typeof m.decodeStellarLendingEvent!=='function')throw new Error('ESM import broken'); console.log('ESM ok')})\" && npm run test:swap",
-    "prepublishOnly": "npm run verify:dist",
+    "prepublishOnly": "npm run verify:dist && npm run test:read",
     "lint": "oxlint src",
     "format": "oxlint src --fix",
     "commit": "git-cz",
@@ -60,7 +70,8 @@
     "docs:stellar": "typedoc --options typedoc.stellar.json",
     "check:examples": "tsc --project tsconfig.examples.json",
     "test:browser": "node --experimental-vm-modules scripts/check-stellar-browser.mjs",
-    "test:swap": "node scripts/check-stellar-swap.mjs"
+    "test:swap": "node scripts/check-stellar-swap.mjs",
+    "test:read": "node --experimental-vm-modules scripts/check-stellar-read.mjs"
   },
   "config": {
     "commitizen": {
@@ -134,5 +145,10 @@
   },
   "peerDependencies": {
     "@stellar/stellar-sdk": ">=15.0.0 <18.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@stellar/stellar-sdk": {
+      "optional": true
+    }
   }
 }

package/dist/index.esm.js.LICENSE.txt

@@ -1,8 +0,0 @@
-/*!
- * The buffer module from node.js, for the browser.
- *
- * @author   Feross Aboukhadijeh <https://feross.org>
- * @license  MIT
- */
-
-/*! ieee754. BSD-3-Clause License. Feross Aboukhadijeh <https://feross.org/opensource> */