# charli3-js

## Docs

- [Charli3 class](https://charli3-js-bc690dc5.mintlify.app/api-reference/charli3.md): The single entry point for reading and refreshing on-chain prices.
- [How the SDK works](https://charli3-js-bc690dc5.mintlify.app/concepts/how-it-works.md): A tour of the moving parts: pull oracle loop, Round 1 signed feeds, Round 2 aggregate tx, and how the SDK wires them together.
- [Compared to the Python SDK](https://charli3-js-bc690dc5.mintlify.app/concepts/vs-python.md): Same on-chain contract, same oracle nodes. Different runtime assumptions.
- [Sample app overview](https://charli3-js-bc690dc5.mintlify.app/example-app/overview.md): The Next.js reference app built for the hackathon. Connect Lace, run the pull-oracle loop, pay a USD invoice in ADA with an AI agent.
- [Run the sample app locally](https://charli3-js-bc690dc5.mintlify.app/example-app/run-locally.md): Copy-paste setup. Five minutes once you have Node and Lace.
- [Demo walkthrough](https://charli3-js-bc690dc5.mintlify.app/example-app/walkthrough.md): Guided tour of every panel in the sample app.
- [AI agents integration](https://charli3-js-bc690dc5.mintlify.app/guides/ai-agents.md): One markdown file that teaches any tool-calling LLM to read and refresh Charli3 prices.
- [Introduction](https://charli3-js-bc690dc5.mintlify.app/introduction.md): A TypeScript SDK for the Charli3 pull oracle on Cardano. One import, one call, a fresh price on chain.
- [Quickstart](https://charli3-js-bc690dc5.mintlify.app/quickstart.md): npm install to a live ADA/USD price in a Next.js app, in under two minutes.
- [SDK guide](https://charli3-js-bc690dc5.mintlify.app/sdk-guide.md): Every function in charli3-js with a working example and what it returns.

## Optional

- [Live demo](https://charli3-js-demo.vercel.app)
- [npm package](https://www.npmjs.com/package/charli3-js)
- [Charli3](https://charli3.io)