Zero to LitAction
- Create an account via the Dashboard, note down your API key
- Run a LitAction
- From the Dashboard
- Programmatically via cURL/JavaScript
- or build your own SDK from the OpenAPI spec
Overview
The Lit Chipotle Dashboard is the front end to the Lit Chipotle API server, designed to quickly and efficiently execute Lit Actions and to manage your user accounts, usage parameters, client wallet creation (PKPs), and IPFS based actions, through a simple set of groups.Specifically it lets you:
- Create accounts and obtain a master account API key.
- Create usage API keys that can be scoped to specific lit-actions or used by dApps.
- Create and manage wallets (PKPs) for signing and on-chain operations.
- Register IPFS CIDs (immutable actions) and scope which wallets have access to them.
- Organize all your resources into groups that combine PKPs, IPFS actions, and usage API keys in any combination.
- Send lit-actions to the node for execution, authorized by a usage or account API key.
Using the Dashboard
The Dashboard is a web management GUI for Lit’s Chipotle offering. Open it from your browser athttps://dashboard.dev.litprotocol.com
It supports light/dark theme for your convenience and provides simple management tools.
Dashboard workflow (recommended order):
- Request a new account (or log in)
- Request usage API keys
- Request new PKPs (wallets)
- Register IPFS CIDs (actions)
- Create groups
- Run lit-actions
1. Request a new account (or log in)
On the login page you have two tabs:- Existing User — Paste your account API key and click Log in. The server checks that the account exists and is mutable.
- New User — Enter an account name and an optional description (and optional initial balance), then click Create account. The server creates the account and returns a new API key and wallet address. Store the API key securely; you’ll need it to manage the account.
You’ll notice a single wallet in your account - it represents your master account API key, and can be used like a standard EVM wallet, or you can safely skip its web3 properties and use the APIs directly.
2. Request usage API keys
Usage API keys are scoped keys you can give to clients or dApps to run specific lit-actions or to deploy. They can be rotated or removed without changing the main account. In the Usage API Keys section, click Add. Set expiration and initial balance, then click Confirm. The server returns a new usage key once — copy and store it. You can optionally set a name and description after creation.Use this key in the
X-Api-Key (or Authorization: Bearer) header when calling the node so that usage is attributed to this key.
3. Request new PKPs (wallets)
PKPs (Programmable Key Pairs) are wallets the lit-nodes can use for signing. In the Wallets section, click Add to create a new wallet to assign to one of your users, or for use in running a lit-action. The server generates a new PKP and returns its address and public key. You can add existing PKPs to groups (see step 5) via Add PKP to group in the Groups section.4. Register IPFS CIDs (actions)
To scope which usage API keys can run which code, you register IPFS CIDs as permitted actions. In the IPFS Actions section, pick a group from the dropdown, then Add an action: enter the IPFS CID of the lit-action and optional name/description. The server hashes the CID and stores it in the group. Only keys that are allowed to use that group can run that action.5. Create groups
Groups logically combine PKPs, IPFS actions, and (indirectly) usage API keys. You can use any combination: e.g., a group with only permitted actions, or only permitted wallets, or both. In the Groups section, click Add to create a group (name, description, optional permitted actions and PKPs, and flags for “all wallets permitted” / “all actions permitted”). Then:- Use IPFS Actions to add CIDs to the group.
- Use Add PKP to group / Remove PKP from group to allow which wallets can be used in that group.
6. Run lit-actions
In the Action Runner section, paste some Lit Action JavaScript code and optional JSON parameters. For exampleDaily Usage
The dashboard is just your human-friendly configuration tool. Once your account and keys are set up to your liking, you can simply call the lit-action endpoint with your usage key each time you, your dApp or cron job needs to execute a lit action. So the only daily use step is- Call the API with your usage key, action-code ( or IPFS CID ) and any parameters that you need
Using the API directly
The same workflows can be done via the REST API. The API itself is under/core/v1/. All endpoints that require authentication expect the API key in a header:
X-Api-Key: your-api-key- or
Authorization: Bearer your-api-key
BASE=api.dev.litprotocol.com and KEY=your_account_or_usage_api_key. The JavaScript examples use the Core SDK (LitNodeSimpleApiClient) from core_sdk.js.
API workflow:
- New account or verify account (login)
- Add usage API key
- Create wallet (PKP)
- Add group and register IPFS action
- Add PKP to group (optional)
- Run lit-action
1. New account or verify account (login)
Create a new account (returns API key and wallet address). Or verify an existing key with theaccount_exists function.
- JavaScript (Core SDK)
- cURL
2. Add usage API key
Create a usage API key with expiration and balance. The response includes the new key only once — store it.- JavaScript (Core SDK)
- cURL
3. Create a wallet (PKP)
Request a new wallet (PKP) for the account. The server returns the wallet address and registers it.- JavaScript (Core SDK)
- cURL
4. Add group and register IPFS action
Create a group (with optional permitted actions and PKPs). Then add an action (IPFS CID) to the group to scope which keys can run it.- JavaScript (Core SDK)
- cURL
5. Add PKP to group (optional)
Restrict which wallets (PKPs) can be used in the group by adding their public keys (or wallet addresses) to the group.- JavaScript (Core SDK)
- cURL
6. Run lit-action
Execute a lit-action by sending JavaScript code and optional params. Use a usage API key in the header.- JavaScript (Core SDK)
- cURL
Other useful endpoints
- list_api_keys — List usage API keys (paginated).
- list_groups — List groups.
- list_wallets — List wallets.
- list_actions — List actions in a group (by
group_id). - list_wallets_in_group — List wallets in a group.
- update_group — Update group name, description, and permission flags.
- remove_action_from_group / remove_pkp_from_group — Remove action or PKP from a group.
- get_node_chain_config — Get node chain config - a quick way to find the location of contracts within the system.
https://api.dev.litprotocol.com/swagger-ui/
Open API Specification
The OpenAPI spec itself can be found at:https://api.dev.litprotocol.com/core/v1/openapi.json Note that these specs are subject to minor changes and will always be available with the dev server endpoints.