[Research] Taproot Assets + L402 Implementation Spike #52

New Issue

replit · 2026-03-21T00:42:33Z

replit commented

2026-03-21 00:42:33 +00:00

What & Why

Produce a concrete technical implementation guide for integrating Taproot Asset tokens ("TIMMY") and L402 payment gating into the Timmy agent. Prioritize what works in production today over what is promised, with exact commands, library versions, gRPC/REST examples, and explicit flags on anything not yet production-ready.

Six research areas to cover

Taproot Asset minting on mainnet using tapd + LND
Taproot Assets in Lightning channels — routing, coexistence with BTC channels, current LND support
L402 payment gate with Taproot Asset payments — Aperture compatibility and custom implementation path
FastAPI + Python integration with tapd — gRPC stubs, REST, LNbits extension status
Hybrid sat + TIMMY credit architecture for the interim period before native TA channels mature
Known failure modes and what is not yet implemented in tapd as of March 2026

Done looks like

A single markdown guide covering all six areas
Each section includes exact CLI commands or gRPC/REST call examples (not pseudocode)
Every item not production-ready is explicitly flagged with an interim workaround
FastAPI section includes a minimal working endpoint: create TA invoice, check payment, issue macaroon on confirmation
Hybrid architecture section provides a concrete pegging strategy (fixed vs floating TIMMY/sat rate) and migration path
Guide distinguishes testnet-only features from mainnet-proven features as of March 2026

Out of scope

Market analysis, token economics opinions
UI or frontend code
Deployment/DevOps for the Lightning node itself
BRC-20

Tasks

Research Taproot Asset minting — tapd version requirements, LND compile flags, gRPC mint call, on-chain cost, single-transaction full supply minting, verification commands.
Research Taproot Asset Lightning channels — LND v0.20+ support status, how TA channels are funded, BTC/TA UTXO coexistence, routing behavior, edge-node BTC conversion.
Research L402 + Taproot Asset integration — Aperture native TA support; if not, minimum custom code path to accept TA payments as L402 credentials.
Research Python/FastAPI + tapd — Most production-ready Python path, LNbits TA extension status March 2026, minimal FastAPI endpoint draft.
Design hybrid sat + TIMMY architecture — Internal credit ledger model, pegging strategy, migration path once native TA channel support matures.
Write the full guide — Assemble into structured markdown with "what works today / what to wait on" summary.

## What & Why Produce a concrete technical implementation guide for integrating Taproot Asset tokens ("TIMMY") and L402 payment gating into the Timmy agent. Prioritize what works in production today over what is promised, with exact commands, library versions, gRPC/REST examples, and explicit flags on anything not yet production-ready. ## Six research areas to cover 1. Taproot Asset minting on mainnet using `tapd` + LND 2. Taproot Assets in Lightning channels — routing, coexistence with BTC channels, current LND support 3. L402 payment gate with Taproot Asset payments — Aperture compatibility and custom implementation path 4. FastAPI + Python integration with `tapd` — gRPC stubs, REST, LNbits extension status 5. Hybrid sat + TIMMY credit architecture for the interim period before native TA channels mature 6. Known failure modes and what is not yet implemented in `tapd` as of March 2026 ## Done looks like - A single markdown guide covering all six areas - Each section includes exact CLI commands or gRPC/REST call examples (not pseudocode) - Every item not production-ready is explicitly flagged with an interim workaround - FastAPI section includes a minimal working endpoint: create TA invoice, check payment, issue macaroon on confirmation - Hybrid architecture section provides a concrete pegging strategy (fixed vs floating TIMMY/sat rate) and migration path - Guide distinguishes testnet-only features from mainnet-proven features as of March 2026 ## Out of scope - Market analysis, token economics opinions - UI or frontend code - Deployment/DevOps for the Lightning node itself - BRC-20 ## Tasks 1. **Research Taproot Asset minting** — `tapd` version requirements, LND compile flags, gRPC mint call, on-chain cost, single-transaction full supply minting, verification commands. 2. **Research Taproot Asset Lightning channels** — LND v0.20+ support status, how TA channels are funded, BTC/TA UTXO coexistence, routing behavior, edge-node BTC conversion. 3. **Research L402 + Taproot Asset integration** — Aperture native TA support; if not, minimum custom code path to accept TA payments as L402 credentials. 4. **Research Python/FastAPI + tapd** — Most production-ready Python path, LNbits TA extension status March 2026, minimal FastAPI endpoint draft. 5. **Design hybrid sat + TIMMY architecture** — Internal credit ledger model, pegging strategy, migration path once native TA channel support matures. 6. **Write the full guide** — Assemble into structured markdown with "what works today / what to wait on" summary.

replit added the ai backend lightning labels 2026-03-21 00:42:33 +00:00

gemini was assigned by Rockachopa

2026-03-22 23:37:26 +00:00

gemini referenced a pull request that will close this issue

2026-03-23 21:23:07 +00:00

[gemini] Complete Taproot Assets + L402 Implementation Spike (#52) #97

gemini commented

2026-03-23 21:23:23 +00:00

PR #97 created. The research spike for Taproot Assets + L402 Implementation is complete. The implementation guide was already present in implementation-guide-taproot-assets-l402-fastapi.md.

PR #97 created. The research spike for Taproot Assets + L402 Implementation is complete. The implementation guide was already present in `implementation-guide-taproot-assets-l402-fastapi.md`.

gemini closed this issue

2026-03-23 21:23:32 +00:00

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: replit/timmy-tower#52