cdp-docs-cli 1.0.0

package/src/templates/prompt/context.md

@@ -0,0 +1,105 @@
+# CDP Wallet Quick Context
+
+This file condenses **all wallet-related docs** so the assistant can grasp core concepts without reading individual markdown files.
+
+---
+## SDK & Auth
+- Library: `@coinbase/cdp-sdk` (TypeScript) / `cdp-sdk` (Python).
+- Required secrets (env):
+  - `CDP_API_KEY_ID`, `CDP_API_KEY_SECRET` – API key pair created in CDP Portal.
+  - `CDP_WALLET_SECRET` – Wallet secret enabling signing.
+
+---
+## Account Types
+| Type | Networks | Notes |
+|------|----------|-------|
+| **EOA** | All EVM compatible | Standard private-key account. Pays its own gas. |
+| **Smart Account (EIP-4337)** | Base Sepolia/Mainnet | Contract wallet with owner EOA; supports gas sponsorship & batching. One SA per owner. |
+| **Solana Account** | Solana mainnet/devnet | Keypair account; signing handled through CDP SDK. |
+
+---
+## Common Operations (TS syntax, mirror in Python)
+### Create or fetch account
+```ts
+const account = await cdp.evm.getOrCreateAccount({ name: 'MyAccount' })
+```
+### Create Smart Account
+```ts
+const sa = await cdp.evm.getOrCreateSmartAccount({ owner: account, name: 'MySA' })
+```
+### Import private key
+```ts
+await cdp.evm.importAccount({ privateKey: '0xabc…', name: 'Imported' })
+```
+### Fund with fiat (beta)
+```ts
+const quote = await account.quoteFund({ network: 'base', token: 'eth', amount: 5n * 10n**14n })
+await quote.execute()
+```
+Or directly:
+```ts
+await account.fund({ network: 'base', token: 'eth', amount: 500000000000000n })
+```
+### Request test tokens
+```ts
+await cdp.evm.requestFaucet({ address: account.address, network: 'base-sepolia', token: 'eth' })
+```
+### Send transaction
+```ts
+await cdp.evm.sendTransaction({
+  address: account.address,
+  network: 'base-sepolia',
+  transaction: { to: '0x…', value: parseEther('0.001') }
+})
+```
+### Sign message / hash (Solana & EVM)
+```ts
+await cdp.solana.signMessage({ address, message: 'hello' })
+```
+
+---
+## Managing Accounts
+- `listAccounts`, pagination via `pageToken`.
+- `updateAccount` allows renaming and attaching `accountPolicy`.
+- Portal UI: https://portal.cdp.coinbase.com/products/wallet-api/accounts
+
+---
+## Policies (Governance Engine)
+- JSON document with `scope` (`project`|`account`), array `rules`.
+- Rule fields: `action` (`accept`|`reject`), `operation` (`signEvmTransaction`, `sendEvmTransaction`, `signEvmMessage`, `signEvmHash`, `signSolTransaction`), `criteria` array.
+- Common criteria helpers: `evmAddress` (allow/deny lists), `ethValue`, `evmNetwork`, `evmData` (ABI-aware), `evmMessage` (regex).
+- Apply policy:
+```ts
+const policy = await cdp.policies.createPolicy({ policy: {/* ... */} })
+await cdp.evm.updateAccount({ address, update: { accountPolicy: policy.id } })
+```
+
+---
+## Import/Export Keys
+- Imports supported for:
+  - EVM private key (hex string)
+  - Solana private key (base58 or raw 32-byte array)
+- Exports require secure enclave; exporting doc currently placeholder.
+
+---
+## Funding (Fiat → Crypto)
+- Beta `quoteFund`/`fund` methods; requires Coinbase consumer account w/ US debit card (non-3DS).
+- Outputs fees & fiat amount, expiration 10 min.
+
+---
+## Quickstart Workflow
+1. **Install**: `npm i @coinbase/cdp-sdk dotenv`.
+2. **Env**: add keys to `.env.local`.
+3. **Instantiate**: `const cdp = new CdpClient()` (auto-reads env vars).
+4. **Create account** → **Faucet** → **Send transaction**.
+5. For SA gas sponsorship or base mainnet deployment, read Smart Accounts guide.
+6. Use faucets sparingly – see rate limits.
+
+---
+## Useful Links
+- Docs home: https://docs.cloud.coinbase.com/wallet-api
+- Policy Engine reference: `/api-reference/v2/rest-api/policy-engine/policy-engine`
+- Discord: https://discord.com/invite/cdp
+
+---
+This summary should provide enough information for an assistant to implement CDP wallet features without reopening the individual docs.

package/src/templates/prompt/directory.md

@@ -0,0 +1,97 @@
+# CDP Wallet Documentation Directory
+
+Use this file as a roadmap for extracting the **exact snippets** needed to implement wallet functionality according to `wallet.md`.
+
+---
+## 1. Quick Overview First
+• **File**: `context.md`  
+• **Lines**: *entire file*  
+• **Why**: Gives a compact summary of SDK auth, account types, operations, policies.
+
+> Read this first to orient yourself—no code yet.
+
+---
+## 2. Project Setup
+| Task | Doc & Section | Lines |
+|------|---------------|-------|
+| Node/Env prerequisites | `/wallet/wallet-start.md` – *Prerequisites* | 20-60 |
+| API Key & Wallet Secret creation | same file – *Create keys* | 65-95 |
+| npm / pip install commands | same file – *Project setup* (TypeScript tab) | 100-150 |
+
+Copy the install commands into your project as described in `wallet.md` → *Installation*.
+
+---
+## 3. Instantiate SDK
+| Task | Doc | Lines |
+|------|-----|-------|
+| Sample instantiation (TS) | `/wallet/wallet-start.md` – first TS code block under *1. Create an account* | 160-180 |
+| Python version (optional) | same file – Python block | 185-205 |
+
+Use the TS snippet to populate `src/lib/cdp.ts` boilerplate.
+
+---
+## 4. Account Workflows
+| Feature | Doc | Lines |
+|---------|-----|-------|
+| Create or fetch EOA | `cdp/wallet/managing-accounts.md` – *EVM Accounts* | 20-55 |
+| Create Smart Account | same file – *Smart Accounts* | 70-115 |
+| Create Solana Account | same file – *Solana Accounts* | 120-160 |
+| List / Update accounts | same file – *Managing Existing Accounts* | 165-260 |
+
+Merge these patterns into helper functions (`createEvmAccount`, `createSmartAccount`, etc.).
+
+---
+## 5. Import / Export Keys
+• **File**: `/wallet/importing.md`  
+  – Use the TS examples under *EVM Accounts* (lines 25-55) and *Solana Accounts* (lines 65-115) to build an `importAccount` utility.
+
+---
+## 6. Funding Accounts
+| Method | Doc | Lines |
+|--------|-----|-------|
+| Testnet Faucet (ETH & SOL) | `/wallet/wallet-start.md` – *2. Fund account with test funds* | 210-315 |
+| Fiat → Crypto (beta) | `/wallet/fund.md` – *Get a quote* & *Execute a quote* | 30-110 |
+
+Implement faucet call in demo; leave fiat-funding optional behind a feature flag.
+
+---
+## 7. Sending Transactions
+| Chain | Doc | Lines |
+|-------|-----|-------|
+| EVM example (viem) | `/wallet/wallet-start.md` – *3. Send a transaction → EVM → TypeScript* | 320-400 |
+| Solana example | same file – *Solana TypeScript* | 405-560 |
+
+Wrap these in `sendEvmTx` and `sendSolTx` helpers.
+
+---
+## 8. Policies (Optional Governance)
+• **File**: `/wallet/policies.md`  
+  – Read *Overview* (lines 1-60) for concept.  
+  – For code, copy TS snippet under *Programmatically* (lines 260-350) to see how to `createPolicy` and `updateAccount`.
+
+Attach policies only if required by product spec.
+
+---
+## 9. Smart Account Gas Sponsorship (Advanced)
+• **File**: `/wallet/wallet-accounts.md`  
+  – Table under *EOA vs Smart Accounts* (lines 40-110) explains benefits.
+
+Use when enabling paymaster / bundler.
+
+---
+## 10. Putting It All Together
+Follow the sequence below aligning with sections in `wallet.md`:
+1. **Install & Env** → Section *Installation* ↔ Docs in step 2.
+2. **Boilerplate Helper** → Section *Boilerplate Code* ↔ Docs in step 3.
+3. **Demo Flow (`demoWallet`)** → Section *Example Usage* ↔ Docs 4-7.
+4. **Questions & Policies** → Use step 8 if needed.
+
+Complete the checklist at the end of `wallet.md`. When each box is satisfied, you've integrated wallets successfully.
+
+---
+### Tips for Efficient Navigation
+1. Use search (`⌘⇧F`) with keywords: `createAccount(`, `requestFaucet(`, `sendTransaction(` to jump quickly.
+2. When copying code, remove `dotenv.config()` if already handled globally.
+3. Keep server-side functions inside the **app router** or `src/lib` to avoid leaking secrets.
+
+Happy building! :rocket: