# Droplit Hosted BSV wallets for apps and agents. Create, deposit, tap, push, fund, mint over HTTP. ## When to use Droplit - Sponsor user transactions from a hosted faucet wallet. - Send agent payouts in satoshis without running your own node. - Write on-chain OP_RETURN payloads (push). - Accept deposits via paymail (`{name}@droplit.dev`). - Run faucet wallets that tap out small drops. - Do not use Droplit as an exchange, a custodial fiat on-ramp, or an Ethereum wallet. It is Bitcoin SV only. ## Services: which host to call - https://droplit.dev/: documentation, discovery (llms.txt, OpenAPI, sitemap), and trust pages. This host does not execute wallet writes. - https://api.droplit.dev: authenticated wallet APIs (register, create, deposit-address, actions). Use BRC-103/104 `AuthFetch`. - https://auth.sigmaidentity.com: Sigma identity (OAuth). Consult its current RFC 8414 metadata for supported grants. Bearer/`bap_id`/`pubkey` are not AuthFetch. ## CLI - npm agent entry: `npx @droplit.dev/cli` (commands: `signup`, `when`, `catalog`, `discover`, `list`, `create`, `status`, `access`, `deposit-address`, `action`, `api-keys`, `quotas`, `withdraw`, `activity`). - Discover: `npx @droplit.dev/cli discover --limit 20 --json` calls unsigned `GET /sponsors`. Only owner-listed names appear; `next_cursor` continues with `--after`. Listing grants no access or funding guarantee; use signed `access` and owner approval. - Signed commands use `--wallet-url ` for an existing BRC-100 SDK HTTP signer. Optional `--originator` defaults to `droplit-cli.local`. `1sat serve wallet` is storage RPC, not signer RPC. `--wif ` remains a mutually exclusive local-signing option; no environment WIF is read. - Create: `npx @droplit.dev/cli create --name [--drop-sats N] --wallet-url `. `--drop-sats` sends JSON `fixed_drop_sats`. - Operate: `npx @droplit.dev/cli action --kind tap|push|mint|fund --name --wallet-url `. - Keys: `npx @droplit.dev/cli api-keys list|add|rm --name --wallet-url `. - Quotas: `npx @droplit.dev/cli quotas list|set --name --wallet-url `. `quotas set --quotas '[]'` clears faucet-level policy. - The unscoped npm name `droplit` is a different package; never `npm i droplit`. ## Use an existing sponsor 1. Reuse your existing signer: `npx @droplit.dev/cli access --name --wallet-url http://127.0.0.1:3321 --json`. Use an actual SDK HTTPWalletJSON signer at that URL. AuthFetch authenticates the same wallet identity; Sigma OAuth alone is not wallet signing. 2. If unauthorized, copy approval_url to the sponsor owner for Review access and Approve access. Opening the link never grants permission. Registration alone does not grant access. 3. Run access again with the same signer after approval. This read does not pay HTTP 402 challenges. Unknown sponsors remain errors; there is no durable pending or denied request resource. 4. Operate within the returned quotas. Missing action kinds are unrestricted for authorized callers; transaction fees are excluded from satoshi quotas. ## Create your own droplit (optional) Register public authentication material with POST https://api.droplit.dev/auth/register and JSON { publicKey: }. This does not approve another sponsor. Create with POST https://api.droplit.dev/faucets and JSON { name: , fixed_drop_sats: 1000 }, then fund the wallet via paymail or deposit-address. Creation provides no free credit. ## Agent deposits Send BSV to paymail `{name}@droplit.dev`, or request a locking address with `POST https://api.droplit.dev/faucet/{name}/deposit-address`. ## Agent operations Call `POST https://api.droplit.dev/faucet/{name}/actions` with BRC-103/104 `AuthFetch` and JSON `kind` tap|push|mint|fund. CLI: `npx @droplit.dev/cli action --kind --name {name} --wallet-url `. Legacy `POST /tap`, `/push`, `/fund`, `/mint` remain. This host does not proxy authenticated writes. Faucet owner is unlimited. Allowlisted keys get N actions per kind per period (rate limit, not a credits ledger, not monthly owner metering). Faucet-level policy: `GET/PUT https://api.droplit.dev/faucet/{name}/action-quotas` (`{ quotas: ActionQuotaSpec[] }`; empty array / no rows = today's unlimited allowlist). CLI: `npx @droplit.dev/cli quotas list|set --name --wallet-url `. Allowlist: `GET/POST https://api.droplit.dev/faucet/{name}/api-keys`, `DELETE https://api.droplit.dev/faucet/{name}/api-keys/{publicKey}`. POST body may include `quotas` (`kind`, `n_per_period`, `period`, optional size/sats caps). `GET https://api.droplit.dev/faucet/{name}/status` is public for balances. Authenticated GET /faucet/{name}/access reports caller public_key, authorized, is_owner, quotas and unrestricted_kinds; it is authoritative for caller policy. Exhausted quota: HTTP 429 JSON `{ "error", "resets_at" }`. `remaining` is null when that kind is unlimited. ## Links - [Docs](https://droplit.dev/docs) - [API introduction](https://droplit.dev/docs/api/introduction) - [API authentication](https://droplit.dev/docs/api/authentication) - [Agents](https://droplit.dev/docs/agents) - [Agent playbooks](https://droplit.dev/docs/agent-playbooks) - [OpenAPI](https://droplit.dev/openapi.json) - [llms-full.txt](https://droplit.dev/llms-full.txt) - [Sitemap](https://droplit.dev/sitemap.xml) - [About](https://droplit.dev/about) - [Contact](https://droplit.dev/contact) - [Privacy](https://droplit.dev/privacy) ## Documentation - [Docs Overview](https://droplit.dev/docs): Integrate Droplit with Sigma-hosted identity and BSV-native signatures. - [Account Abstraction & Paymasters](https://droplit.dev/docs/account-abstraction): How Droplit provides ERC-4337-style account abstraction and paymaster functionality on Bitcoin. - [Agent Playbooks](https://droplit.dev/docs/agent-playbooks): Executable playbooks for agents operating Droplit. - [Agents](https://droplit.dev/docs/agents): How an agent signs up, creates a droplit, and deposits. - [Authentication](https://droplit.dev/docs/api/authentication): BRC-103/104 mutual authentication for the Droplit API. - [API Introduction](https://droplit.dev/docs/api/introduction): Getting started with the Droplit API. - [Permission Model](https://droplit.dev/docs/api/permission-model): Practical least-privilege patterns for Droplit API access. - [WebSocket Activity Stream](https://droplit.dev/docs/api/sse-activity-stream): Authenticated real-time WebSocket events for droplit activity. - [Authentication](https://droplit.dev/docs/authentication): How to authenticate Droplit requests with BRC-103/104. - [Fund Transaction Endpoint](https://droplit.dev/docs/fund-transaction): Fund pre-signed transactions using Droplit as a paymaster. - [Mint Inscriptions Endpoint](https://droplit.dev/docs/mint-inscriptions): Learn how to mint ordinal inscriptions and BSV21 tokens from your Droplit instance. - [Push Data Endpoint](https://droplit.dev/docs/push-data): Learn how to push data to your Droplit instance. - [Tap Faucet Endpoint](https://droplit.dev/docs/tap-faucet): Learn how to dispense satoshis from your Droplit instance.