# 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: OAuth and Sigma device authorization (RFC 8628).

## CLI
- npm agent entry: `npx @droplit.dev/cli` (commands: `signup`, `when`, `catalog`).
- The unscoped npm name `droplit` is a different package; never `npm i droplit`.

## Agent signup
1. Identity: autonomous service agents use `ProtoWallet` from a WIF in an environment variable plus `AuthFetch` (`@bsv/sdk`). Human-approved agents complete Sigma device authorization at https://auth.sigmaidentity.com (`/api/auth/device/code` and `/api/auth/device/token`), then the same `AuthFetch`.
2. Register: `POST https://api.droplit.dev/auth/register` with JSON `{ "publicKey": "<compressed-public-key-hex>" }`. A bodyless POST is 400.
3. Create a droplit: `POST /faucets` on https://api.droplit.dev with JSON `{ "name": "your-droplit", "drop_sats": 1000 }` (optional `target_buckets`, `current_bucket_idx`, `max_consolidation_inputs`).
4. Deposit: paymail `{name}@droplit.dev` or `POST https://api.droplit.dev/faucet/{name}/deposit-address`.

## 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`. Legacy `POST /tap`, `/push`, `/fund`, `/mint` remain. This host does not proxy authenticated writes.

## 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): Production-oriented integration playbooks for Droplit + Sigma.
- [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.