This server exposes a REST API used by the Core, Transfer, and Swaps JavaScript SDKs. The SDKs wrap the API endpoints so you can call them from the browser or Node. Demo apps include Solver (for solvers: view swap requests, commit to quotes, process swaps), SWPS (for users: request swaps and manage flow), and the Lit Express Node dashboard (manage accounts, groups, wallets, and IPFS actions).

Lit Express Node dashboard

Lit Express Node dashboard

Desktop app (light/dark mode) for Lit Express Node (AccountConfig contract): log in with an API key or create a new account; create wallets and add existing PKPs to groups; list and create groups; add IPFS CIDs (permitted actions) to groups. Uses the Core SDK and mirrors the contract’s accounts, groups, and actions.

Open: dapps/dashboard/

API reference

Core V1 OpenAPI spec

Interactive OpenAPI (Swagger) documentation for /core/v1/: all endpoints, request and response schemas, and "Try it out" to call the API from the browser. Covers new account, create wallet, sign with PKP, lit action, add/remove group, PKP and usage API keys, and list groups, wallets, and actions.

Open: swagger-ui/

AccountConfig contract (Solidity)

Developer documentation for the AccountConfig.sol contract: errors, structs (Metadata, UsageApiKey, Group, Account), state variables, and all functions with NatSpec (accounts, groups, wallets, usage API keys, list/query, balance & pricing).

Open: solidity_contract.html

JavaScript APIs

Core SDK (core_sdk.js)

Wraps the v1 core API: get API key, sign with PKP, run Lit actions, encrypt/decrypt. Routes are mounted at /core/v1/. Use this for PKP-based signing and Lit Actions.

Docs: docs/client/js-core-sdk.html

Code: core_sdk.js

Transfer SDK (transfer_sdk.js)

Wraps transfer endpoints: get balance, send transfer (PKP wallet to destination). Routes are mounted at /transfer/v1/. Use this to move assets from a PKP-controlled wallet.

Docs: docs/client/js-transfer-sdk.html

Code: transfer_sdk.js

Swaps SDK (swaps_sdk.js)

Wraps swap intents: token list, new quote request, fill quote, accept quote, swap status, open swap requests/quotes, quote balances, attempt swap. Routes are mounted at /swaps/v1/. Use this to build swap flows and solver UIs.

Docs: docs/client/js-swaps-sdk.html

Code: swaps_sdk.js

Sample test page

Simple API test

Interactive test page to try core and transfer endpoints: get API key, sign with PKP, get balance, send transfer. Configure base URL and use the forms to call the APIs.

Open: simple_api_test.html

Demo apps

Solver app

For solvers/liquidity providers. View open swap requests and open quotes in tables, commit to a quote via MetaMask (newQuote), check PKP balances for a quote, and process a swap (attempt_swap_request). Uses the Swaps SDK and ethers for wallet signing.

Open: dapps/solver/

SWPS app

For end users requesting swaps. Request a swap (origin/destination token and chain), view token list, and follow the swap flow. Uses the Swaps SDK to create quote requests and interact with the swap API.

Open: dapps/swps/