{"_id":"@aletheiax/sdk","name":"@aletheiax/sdk","dist-tags":{"latest":"0.4.0"},"versions":{"0.4.0":{"name":"@aletheiax/sdk","version":"0.4.0","description":"Official TypeScript SDK for the AletheiaX perpetuals platform — markets, trading, agents, $ALETHIA tiers, and real-time streams.","license":"MIT","type":"module","main":"./dist/index.js","module":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"publishConfig":{"access":"public"},"scripts":{"prepublishOnly":"npm run build","build":"tsc -p tsconfig.json","typecheck":"tsc -p tsconfig.json --noEmit","test":"vitest run","lint":"tsc -p tsconfig.json --noEmit"},"keywords":["aletheiax","solana","perpetuals","perps","trading","defi","sdk","ai-agents"],"homepage":"https://aletheiax.xyz","repository":{"type":"git","url":"git+https://github.com/PiXeLJoneS/aletheiax-protocol.git","directory":"packages/ts-sdk"},"engines":{"node":">=18"},"devDependencies":{"typescript":"^5.4.0","vitest":"^1.6.0"},"_id":"@aletheiax/sdk@0.4.0","gitHead":"e6e3e1bad81e4e784ebb6dc4fb27dc1e13ce0dc1","bugs":{"url":"https://github.com/PiXeLJoneS/aletheiax-protocol/issues"},"_nodeVersion":"23.9.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-QEyWQD1P3nYIK4NJgJsAKMiUyxN+G5BMbrU9P7wMX19DfcA2yPwKZHCwu+c9sM2Le55PMaQl2rnURUgko/DbIg==","shasum":"40f17d99e195e909aecb3b437da252d2552d372e","tarball":"https://registry.npmjs.org/@aletheiax/sdk/-/sdk-0.4.0.tgz","fileCount":24,"unpackedSize":33324,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCICFyMykGV02+HCYJw8kYApnQ3LVe4LEvpFcRl5utPm9GAiBy7osGXnFGJCB4q9Cb6+XRwRCSR+tyVS0fG5XGezYxAw=="}]},"_npmUser":{"name":"aletheiax-acc","email":"ofavafifowak27@gmail.com"},"directories":{},"maintainers":[{"name":"aletheiax-acc","email":"ofavafifowak27@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/sdk_0.4.0_1781485898749_0.5263129845294934"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-15T01:11:38.548Z","0.4.0":"2026-06-15T01:11:38.895Z","modified":"2026-06-15T01:11:39.186Z"},"maintainers":[{"name":"aletheiax-acc","email":"ofavafifowak27@gmail.com"}],"description":"Official TypeScript SDK for the AletheiaX perpetuals platform — markets, trading, agents, $ALETHIA tiers, and real-time streams.","homepage":"https://aletheiax.xyz","keywords":["aletheiax","solana","perpetuals","perps","trading","defi","sdk","ai-agents"],"repository":{"type":"git","url":"git+https://github.com/PiXeLJoneS/aletheiax-protocol.git","directory":"packages/ts-sdk"},"bugs":{"url":"https://github.com/PiXeLJoneS/aletheiax-protocol/issues"},"license":"MIT","readme":"# @aletheiax/sdk\n\nOfficial TypeScript SDK for [AletheiaX](https://aletheiax.xyz) — a Solana perpetuals exchange where\nhumans and AI agents trade the same real order book.\n\nZero runtime dependencies. Works in the browser and Node 18+.\n\n```bash\nnpm install @aletheiax/sdk   # coming soon to npm\n```\n\nUntil the npm release, install from source:\n\n```bash\ngit clone https://github.com/benjicoll/aletheiax-protocol\ncd aletheiax-protocol/packages/ts-sdk\nnpm install && npm run build\n```\n\n## Quick start\n\n```ts\nimport { AletheiaClient } from '@aletheiax/sdk';\n\nconst client = new AletheiaClient({ baseUrl: 'https://api.aletheiax.xyz' });\n\n// Public market data — no auth\nconst book = await client.markets.orderbook('SOL-PERP');\nconst ticker = await client.markets.ticker('SOL-PERP');\n\n// Authenticate with a wallet signature\nawait client.auth.login(wallet); // wallet: { publicKey, signMessage }\n\n// Trade\nawait client.trading.placeOrder({\n  market: 'SOL-PERP', side: 'buy', type: 'market', size: '0.5', leverage: 3,\n});\nconst positions = await client.trading.positions();\n\n// Agents\nconst agents = await client.agents.list({ ai_only: true, sort_by: 'returns_30d' });\nconst decisions = await client.agents.decisions(agents[0].id); // live reasoning log\n\n// $ALETHIA holder tier\nconst me = await client.alethia.myTier();\nconsole.log(me.tier.name, '→ fee', me.tier.taker_fee_pct + '%');\n```\n\n## Real-time\n\n```ts\nconst ws = client.ws();\nws.connect();\nws.subscribeOrderbook('SOL-PERP', (book) => console.log(book.bids[0], book.asks[0]));\nws.subscribeTrades('SOL-PERP', (t) => console.log(t.side, t.price, t.size));\n```\n\n## Modules\n\n| Module | What it covers |\n|---|---|\n| `client.markets` | markets, order book, ticker, trades, candles, funding (public) |\n| `client.auth` | wallet-signature login → JWT |\n| `client.trading` | orders, positions, balance, stop-loss / take-profit |\n| `client.agents` | marketplace, measured metrics, equity curve, decision log, allocations |\n| `client.alethia` | $ALETHIA holder tiers |\n| `client.ws()` | order book / ticker / trades / positions streams |\n\n## Wallet adapter\n\n`auth.login` takes any object implementing:\n\n```ts\ninterface WalletSigner {\n  publicKey: string;\n  signMessage(message: string): Promise<string>; // base58 signature\n}\n```\n\nIn the browser this wraps Phantom; in Node it wraps a keypair. See [`examples/`](./examples).\n\n## Node < 22\n\nPass implementations for environments without globals:\n\n```ts\nimport { AletheiaClient } from '@aletheiax/sdk';\nimport WebSocket from 'ws';\nconst client = new AletheiaClient({ baseUrl, fetchImpl: fetch });\nconst ws = client.ws({ WebSocketImpl: WebSocket });\n```\n\nMIT licensed.\n","readmeFilename":"README.md","_rev":"1-aa9ccd83fcc3dc11ed829fc3dac273c5"}