chore: migrate rust/basic_bitcoin to icp-cli

[marc0olo]

Summary

Migrates rust/basic_bitcoin from dfx to icp-cli and adds full Bitcoin asset protocol support: Ordinals inscriptions, Runes fungible tokens, and BRC-20 tokens.

Migration to icp-cli

• Replaces dfx.json + Makefile + build.sh with icp.yaml + build-image.sh
• Adds Dockerfile and docker/start.sh to self-contain the bitcoind + ord environment
• Source files moved under backend/src/ to match icp-cli project layout
• Adds test.sh with an end-to-end test suite covering all endpoints

New Bitcoin asset protocol endpoints

Ordinals

• transfer_ordinal(reveal_txid, recipient_address) — transfers an existing inscription to a new owner by spending the reveal UTXO to the recipient's address at vout 0, preserving ordinal satoshi tracking

Runes

• commit_rune(name) / etch_rune(name) — two-step etching: step 1 creates the commitment UTXO on-chain; step 2 is called after 6 blocks (enforced via MinConfirmations(6)) and broadcasts the etch transaction with a Runestone embedding all token parameters
• transfer_rune(rune_id, amount, recipient_address) — transfers rune tokens; uses a Runestone edict to allocate tokens to the recipient at vout 0, with pointer: 2 directing unallocated rune change to the dedicated rune address at vout 2
• get_rune_address() — returns the canister's dedicated Taproot rune address (derived at p2tr(0,1))

BRC-20

• inscribe_brc20(tick, max, lim) — deploys a BRC-20 token by inscribing a deploy JSON
• mint_brc20(tick, amount, recipient_address) — mints tokens by inscribing a mint JSON to the recipient's address
• transfer_brc20(tick, amount, recipient_address) — three-step BRC-20 transfer: commit → reveal (inscription at sender's address) → send (inscription UTXO to recipient); the reveal output value is forwarded to the send transaction to satisfy BIP341 sighash commitment

New backend modules

• runes.rs — Runes protocol encoding: LEB128 (u64 and u128 variants), rune name encoding (u128 to handle names ≥14 characters), build_etching_script, build_transfer_script with edict delta encoding and pointer support, build_rune_commit_script
• brc20.rs — BRC-20 JSON envelope construction and commit/reveal transaction building
• ordinals.rs (expanded) — rune etch transaction builder added alongside the existing ordinal reveal builder; checked_sub used throughout to avoid arithmetic traps

README

Complete rewrite with step-by-step walkthroughs for all three asset protocols, including environment setup, expected command output, and links to the ord explorer.

CI

Adds a rust-basic_bitcoin job in .github/workflows/basic_bitcoin.yml that runs on a bare ubuntu-24.04 host (required for Docker access) and installs candid-extractor before building.

🤖 Generated with Claude Code

[Copilot]

Pull request overview

This PR migrates the rust/basic_bitcoin example from dfx to icp-cli, restructures it into the canonical Rust workspace layout (backend/), and adds canister endpoints and local regtest tooling for Bitcoin asset protocols (Ordinals, Runes, BRC-20).

Changes:

• Migrates the example to icp-cli (icp.yaml), introduces a custom network launcher Docker image, and replaces legacy dfx build/deploy artifacts.
• Adds/rewrites Rust backend modules and services for Ordinals / Runes / BRC-20 flows, plus supporting transaction-building utilities.
• Adds CI for the Rust variant and introduces a test.sh script for basic end-to-end validation.

Reviewed changes

Copilot reviewed 35 out of 54 changed files in this pull request and generated 8 comments.

Show a summary per file

File	Description
rust/basic_bitcoin/test.sh	Adds an e2e smoke-test script for basic Bitcoin API functionality.
rust/basic_bitcoin/src/service/inscribe_brc20.rs	Removes legacy (pre-migration) service implementation.
rust/basic_bitcoin/src/service/etch_rune.rs	Removes legacy (pre-migration) service implementation.
rust/basic_bitcoin/src/runes.rs	Removes legacy runes encoding module (moved/replaced under backend/).
rust/basic_bitcoin/src/brc20.rs	Removes legacy BRC-20 script builder (moved/replaced under backend/).
rust/basic_bitcoin/README.md	Updates documentation for icp-cli deployment + asset protocol walkthroughs.
rust/basic_bitcoin/ord.yaml	Updates ord configuration (RPC password + ord db directory).
rust/basic_bitcoin/Makefile	Removes legacy dfx Makefile targets.
rust/basic_bitcoin/icp.yaml	Adds icp-cli project config + local network settings + env init args.
rust/basic_bitcoin/Dockerfile	Adds custom network launcher image layering bitcoind into the launcher base.
rust/basic_bitcoin/docker/start.sh	Adds container entrypoint to start bitcoind then exec the network launcher.
rust/basic_bitcoin/dfx.json	Removes legacy dfx project configuration.
rust/basic_bitcoin/Cargo.toml	Converts the project into a workspace rooted at backend/.
rust/basic_bitcoin/Cargo.lock	Updates lockfile for workspace rename/package changes and dependency bumps.
rust/basic_bitcoin/build.sh	Removes legacy build script.
rust/basic_bitcoin/build-image.sh	Adds helper script to build the custom network launcher Docker image.
rust/basic_bitcoin/bitcoin.conf	Updates bitcoind config (RPC password).
rust/basic_bitcoin/basic_bitcoin.did	Removes legacy candid file.
rust/basic_bitcoin/backend/src/service/transfer_rune.rs	Adds Rune transfer endpoint and tx construction/signing logic.
rust/basic_bitcoin/backend/src/service/transfer_ordinal.rs	Adds ordinal transfer endpoint spending the reveal UTXO.
rust/basic_bitcoin/backend/src/service/transfer_brc20.rs	Adds BRC-20 transfer flow (commit/reveal + send).
rust/basic_bitcoin/backend/src/service/send_from_p2wpkh_address.rs	Adds native SegWit (P2WPKH) sending endpoint.
rust/basic_bitcoin/backend/src/service/send_from_p2tr_script_path_enabled_address_script_spend.rs	Adds Taproot script-path spending send endpoint.
rust/basic_bitcoin/backend/src/service/send_from_p2tr_script_path_enabled_address_key_spend.rs	Adds Taproot key-path spending for script-path-enabled address.
rust/basic_bitcoin/backend/src/service/send_from_p2tr_key_path_only_address.rs	Adds BIP-86 style Taproot key-path-only send endpoint.
rust/basic_bitcoin/backend/src/service/send_from_p2pkh_address.rs	Adds legacy P2PKH send endpoint.
rust/basic_bitcoin/backend/src/service/mint_brc20.rs	Adds BRC-20 mint inscription endpoint.
rust/basic_bitcoin/backend/src/service/inscribe_ordinal.rs	Adds ordinal inscription (commit/reveal) endpoint.
rust/basic_bitcoin/backend/src/service/inscribe_brc20.rs	Adds BRC-20 deploy inscription endpoint.
rust/basic_bitcoin/backend/src/service/get_utxos.rs	Adds get-utxos endpoint passthrough to the Bitcoin canister.
rust/basic_bitcoin/backend/src/service/get_rune_address.rs	Adds helper endpoint returning the canister’s dedicated rune address.
rust/basic_bitcoin/backend/src/service/get_p2wpkh_address.rs	Adds P2WPKH address derivation endpoint.
rust/basic_bitcoin/backend/src/service/get_p2tr_script_path_enabled_address.rs	Adds Taproot script-path-enabled address derivation endpoint.
rust/basic_bitcoin/backend/src/service/get_p2tr_key_path_only_address.rs	Adds Taproot key-path-only address derivation endpoint.
rust/basic_bitcoin/backend/src/service/get_p2pkh_address.rs	Adds P2PKH address derivation endpoint.
rust/basic_bitcoin/backend/src/service/get_current_fee_percentiles.rs	Adds fee percentile query endpoint.
rust/basic_bitcoin/backend/src/service/get_blockchain_info.rs	Adds blockchain-info query endpoint.
rust/basic_bitcoin/backend/src/service/get_block_headers.rs	Adds block-headers query endpoint.
rust/basic_bitcoin/backend/src/service/get_balance.rs	Adds balance query endpoint.
rust/basic_bitcoin/backend/src/service/etch_rune.rs	Implements 2-step rune commit + etch flow with confirmation gating.
rust/basic_bitcoin/backend/src/service.rs	Wires newly added service modules into the backend crate.
rust/basic_bitcoin/backend/src/schnorr.rs	Adds Schnorr public key caching and signing helpers (+ mock signer).
rust/basic_bitcoin/backend/src/runes.rs	Adds Runes encoding utilities, commitment bytes, and runestone builders.
rust/basic_bitcoin/backend/src/p2wpkh.rs	Adds P2WPKH tx building + signing helpers with fee iteration.
rust/basic_bitcoin/backend/src/p2tr.rs	Adjusts Taproot tx builder logic to match updated primary output shape.
rust/basic_bitcoin/backend/src/p2pkh.rs	Adjusts P2PKH tx builder logic to match updated primary output shape.
rust/basic_bitcoin/backend/src/ordinals.rs	Improves fee underflow handling and adds rune etch tx builder helpers.
rust/basic_bitcoin/backend/src/lib.rs	Updates init logic, adds request types, and exports candid.
rust/basic_bitcoin/backend/src/ecdsa.rs	Adds ECDSA public key caching and signing helpers (+ mock signer).
rust/basic_bitcoin/backend/src/common.rs	Updates UTXO selection and simplifies PrimaryOutput to address-only.
rust/basic_bitcoin/backend/src/brc20.rs	Adds shared commit+reveal implementation and BRC-20 reveal script builder.
rust/basic_bitcoin/backend/Cargo.toml	Adds backend crate manifest and dependencies.
rust/basic_bitcoin/.gitignore	Adds ignore for ord index DB directory.
.github/workflows/basic_bitcoin.yml	Adds Rust CI job that builds the custom Docker image and runs test.sh.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.