{"_id":"@arqoracle/oracle","name":"@arqoracle/oracle","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@arqoracle/oracle","version":"0.1.0","description":"TypeScript SDK for ARQ Oracle on Robinhood Chain","license":"MIT","type":"module","main":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"publishConfig":{"access":"public"},"homepage":"https://github.com/arqoracle/arq-oracle-sdk#readme","bugs":{"url":"https://github.com/arqoracle/arq-oracle-sdk/issues"},"repository":{"type":"git","url":"git+https://github.com/arqoracle/arq-oracle-sdk.git"},"keywords":["oracle","robinhood","defi","price-feeds","blockchain","arq","arqoracle"],"scripts":{"build":"tsc","example":"npm run build && tsx examples/quickstart.ts","prepublishOnly":"npm run build","prepack":"npm run build"},"engines":{"node":">=18"},"devDependencies":{"tsx":"^4.19.0","typescript":"^5.0.0"},"gitHead":"5425ce05f4a5675b2f6dd60c5aceb77b49bb0ad6","_id":"@arqoracle/oracle@0.1.0","_nodeVersion":"24.12.0","_npmVersion":"11.6.2","dist":{"integrity":"sha512-jjtJnxWCKwq4es8FW47dSIvqPymroaLlqTNVoJHJkYLGdZRBzPHV0dn5lWVBA4ge+qglrqtCSgSNUUYNMz1IiQ==","shasum":"8dc9a26a4ff3c00d5444e2428953456775b9fef7","tarball":"https://registry.npmjs.org/@arqoracle/oracle/-/oracle-0.1.0.tgz","fileCount":9,"unpackedSize":15848,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCylYVNdfoeCbUv+71oV661r56kMoLc5HNYzwthuhAIOwIgYBugjwyT/G0CldmaBh4tU6ru+9v2wx4BUB/hlfWl9q8="}]},"_npmUser":{"name":"arqoracle","email":"hello@arq-oracle.com"},"directories":{},"maintainers":[{"name":"arqoracle","email":"hello@arq-oracle.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/oracle_0.1.0_1783854374363_0.6873314940199595"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-12T11:06:14.237Z","0.1.0":"2026-07-12T11:06:14.533Z","modified":"2026-07-12T11:06:14.759Z"},"maintainers":[{"name":"arqoracle","email":"hello@arq-oracle.com"}],"description":"TypeScript SDK for ARQ Oracle on Robinhood Chain","homepage":"https://github.com/arqoracle/arq-oracle-sdk#readme","keywords":["oracle","robinhood","defi","price-feeds","blockchain","arq","arqoracle"],"repository":{"type":"git","url":"git+https://github.com/arqoracle/arq-oracle-sdk.git"},"bugs":{"url":"https://github.com/arqoracle/arq-oracle-sdk/issues"},"license":"MIT","readme":"<p align=\"center\">\r\n  <img src=\"./public/thumbnail.png\" alt=\"@arqoracle/oracle SDK\" width=\"100%\" />\r\n</p>\r\n\r\n# @arqoracle/oracle\r\n\r\n[![TypeScript](https://img.shields.io/badge/TypeScript-5-blue?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)\r\n[![Robinhood Chain](https://img.shields.io/badge/Chain-Robinhood-00C805)](https://robinhood.com/chain)\r\n[![Website](https://img.shields.io/badge/Website-arq--oracle.com-blue)](https://arq-oracle.com/)\r\n\r\nTypeScript SDK for [ARQ Oracle](https://arq-oracle.com) — council-signed price feeds on **Robinhood Chain**.\r\n\r\nSame package name as on the website: `npm i @arqoracle/oracle`\r\n\r\n## Install\r\n\r\n```bash\r\nnpm i @arqoracle/oracle\r\n```\r\n\r\n## Supported feeds\r\n\r\n```ts\r\nimport { FEEDS, FEED_IDS, isSupportedFeed } from \"@arqoracle/oracle\";\r\n\r\nconsole.log(FEED_IDS);\r\n// [\"ETH/USD\", \"BTC/USD\", \"SOL/USD\", \"XRP/USD\", \"DOGE/USD\", \"LINK/USD\"]\r\n\r\nisSupportedFeed(\"ETH/USD\"); // true\r\n```\r\n\r\nFetch every supported feed in one request:\r\n\r\n```ts\r\nimport { getAllPrices } from \"@arqoracle/oracle\";\r\n\r\nconst prices = await getAllPrices();\r\nconsole.log(prices[\"ETH/USD\"]?.value);\r\nconsole.log(prices[\"BTC/USD\"]?.value);\r\n```\r\n\r\nVerify a round (same checks as ARQ Lab):\r\n\r\n```ts\r\nimport { verifyRound } from \"@arqoracle/oracle\";\r\n\r\nconst result = await verifyRound(\"0x1a2b3c\", \"ETH/USD\");\r\n\r\nconsole.log(result.verified);\r\nconsole.log(result.checks.oracleAuthorization.passed);\r\nconsole.log(result.price, result.councils);\r\n```\r\n\r\n## Quick start\r\n\r\n```ts\r\nimport { getPrice, verifySig, assertFresh } from \"@arqoracle/oracle\";\r\n\r\nconst r = await getPrice(\"ETH/USD\");\r\n\r\nif (!verifySig(r)) throw new Error(\"bad signature\");\r\n\r\nassertFresh(r, 2000);\r\n\r\nconsole.log(r.value, r.timestamp);\r\n```\r\n\r\n## Errors\r\n\r\n```ts\r\nimport { getPrice, ArqError, isArqError } from \"@arqoracle/oracle\";\r\n\r\ntry {\r\n  await getPrice(\"ETH/USD\");\r\n} catch (err) {\r\n  if (isArqError(err)) {\r\n    console.log(err.code); // e.g. API_ERROR, STALE_DATA, FEED_NOT_FOUND\r\n  }\r\n}\r\n```\r\n\r\n## Build\r\n\r\n```bash\r\nnpm install\r\nnpm run build\r\n```\r\n\r\n## Example\r\n\r\n```bash\r\nnpm run example\r\n```\r\n\r\nSee [`examples/quickstart.ts`](./examples/quickstart.ts) — same flow as the [SDK docs](https://arq-oracle.com/sdk).\r\n\r\n## API\r\n\r\n| Function | Description |\r\n|----------|-------------|\r\n| `getPrice` | Latest feed price |\r\n| `getAllPrices` | All supported feeds in one call |\r\n| `verifyRound` | Lab-style round verification by round ID |\r\n| `verifySig` / `verifySignature` | Check proof validity |\r\n| `assertFresh` | Reject stale data |\r\n| `getRound` | Latest on-chain round |\r\n| `createClient` | Configurable client instance |\r\n| `ArqError` / `isArqError` | Typed SDK errors |\r\n\r\n## Links\r\n\r\n- **SDK docs:** https://arq-oracle.com/sdk\r\n- **API reference:** https://arq-oracle.com/api-docs\r\n- **Main app:** https://github.com/arqoracle/arqoracle\r\n","readmeFilename":"README.md","_rev":"1-96011296096e3f66272e345c6f1fbf71"}