Stacks (Bitcoin L2) Integration

[Xaxxoo]

Description:
Implement Stacks blockchain integration for Bitcoin-secured settlements.
Tasks:

Install Stacks.js dependencies
Create StacksService with API client
Implement wallet generation and management
Add USDC token integration (SIP-010)
Create transaction building
Implement transaction broadcasting
Add transaction monitoring
Create confirmation tracking (Bitcoin blocks)
Implement token transfer parsing
Add balance checking
Create fee estimation
Implement error handling
Add testnet and mainnet configuration
Create nonce management
Implement unit tests
Add integration tests with testnet

Acceptance Criteria:

Stacks transactions are broadcast successfully
Bitcoin-secured finality is tracked
Token transfers are detected
Fees are properly calculated

[drips-wave]

This issue has been added to the Stellar Wave Program and is worth 200 Points.

🧑‍💻 Interested in contributing? Apply to work on this issue on Drips Wave, earn points, and receive rewards.

Warning

Only applications submitted via the apply link above will be considered. Please do not apply by commenting on the issue or opening a PR directly.

🤠 Repo maintainers: You can manage this issue's Points and Complexity on your Maintainer Dashboard here. Please keep an eye on applications and respond quickly 💙

ℹ️ Learn more about Drips Wave

[soomtochukwu]

@soomtochukwu has applied to work on this issue as part of the Stellar Wave Program's 1st wave.

Hi! Can you assign this to me? I’ll use Stacks.js to implement Bitcoin-secured settlements, SIP-010 USDC transfers, and reliable transaction monitoring.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @soomtochukwu to this issue.

[Georgechisom]

@Georgechisom has applied to work on this issue as part of the Stellar Wave Program's 1st wave.

Hi, I would love to work on this issue, please help assign it to me

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Georgechisom to this issue.

[Themancalledpg]

@Themancalledpg has applied to work on this issue as part of the Stellar Wave Program's 1st wave.

Hi, my name is Preciousgift, and I am a fullstack and smart contract developer skilled in React, Next.js, JavaScript, TypeScript, Tailwind CSS, and Soroban. For this task, I will:
Install and configure Stacks.js, creating a StacksService for wallet management, transaction building, and broadcasting.
Integrate USDC token support (SIP-010) with balance checking, fee estimation, and nonce management.
Implement transaction monitoring, confirmation tracking via Bitcoin blocks, and token transfer parsing.
Write unit and integration tests on testnet to ensure broadcast success, fee accuracy, and proper token detection.
ETA: 10 hours

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Themancalledpg to this issue.

[walterthesmart]

@walterthesmart has applied to work on this issue as part of the Stellar Wave Program's 1st wave.

Hi @Xaxxoo, I would like to work on this issue.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @walterthesmart to this issue.

[Chucks1093]

@Chucks1093 has applied to work on this issue as part of the Stellar Wave Program's 1st wave.

Hello Xaxxoo, I’ve handled chain integrations where you need clean signing, monitoring, and confirmation tracking, and this is how I would approach it.

• Install Stacks.js deps and create a StacksService that wraps API client setup for testnet and mainnet, with a single config map for base URLs, chain params, and fee defaults.
• Implement wallet generation and management with safe key handling inside the service, and expose only high-level methods like buildTransfer, broadcastTx, getBalance, and getTxStatus.
• Add SIP-010 USDC support by integrating the token contract calls for balance and transfers, and normalize transfer parsing into a common internal event shape for the rest of the app.
• Implement monitoring with cursor persistence and confirmation tracking based on Bitcoin block confirmations, including retry and backoff for API errors without advancing cursors on failure.
• Add fee estimation and nonce management so repeated sends are reliable, then cover core flows with unit tests using mocked API responses and integration tests against testnet.

This should be completed within about 16 to 24 hours.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Chucks1093 to this issue.

[Emmy123222]

@Emmy123222 has applied to work on this issue as part of the Stellar Wave Program's 1st wave.

can i work on this please ??

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Emmy123222 to this issue.

[JoE11-y]

@JoE11-y has applied to work on this issue as part of the Stellar Wave Program's 1st wave.

Hi there!

I'd love to pick up this issue. I understand the scope of the task and can submit a PR soon if assigned.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @JoE11-y to this issue.

[abdegenius]

@abdegenius has applied to work on this issue as part of the Stellar Wave Program's 1st wave.

I have reviewed the task requirements and it falls within my skillset.. I will love to work on this issue

ℹ️ Repo Maintainers: To accept this application, review their application or assign @abdegenius to this issue.

[Properprogress1]

@Properprogress1 has applied to work on this issue as part of the Stellar Wave Program's 1st wave.

Hi there,

I’d like to take on Issue #44: Stacks (Bitcoin L2) Integration. This integration is essential for enabling Bitcoin-secured settlements with USDC tokens, providing robust cross-chain capabilities for the platform. This falls within skillset

Planned Approach:

Implement StacksService with Stacks.js for wallet management, transaction building, broadcasting, and confirmation tracking

Integrate SIP-010 USDC token support and handle token transfers and balance checks

Track Bitcoin-backed finality, estimate fees, and manage nonces for secure transactions

Implement error handling, and support both testnet and mainnet

Write unit and integration tests to ensure all transactions broadcast correctly and token movements are accurately detected

This will ensure secure, reliable, and auditable Bitcoin-layer transactions, unlocking full cross-chain functionality for the platform.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Properprogress1 to this issue.

[tali-creator]

@tali-creator has applied to work on this issue as part of the Stellar Wave Program's 1st wave.

I’ve carefully gone through the issue description and taken time to understand the existing codebase and expected outcome. Based on my experience and the scope of this task, I’m confident I fully understand what needs to be done and how it fits into the project’s overall architecture.

I’m a full-stack Stark developer with 4+ years of hands-on experience, and I’m very confident in my ability to deliver a solid, production-ready solution. I’m 100% certain I can complete this task within 24 hours while maintaining code quality, clarity, and alignment with the project’s standards. I’d be glad to take this on and contribute effectively if assigned.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @tali-creator to this issue.

[ShantelPeters]

@ShantelPeters has applied to work on this issue as part of the Stellar Wave Program's 1st wave.

can i please be assigned to this issue ?

ℹ️ Repo Maintainers: To accept this application, review their application or assign @ShantelPeters to this issue.

[drips-wave]

Congratulations, @tali-creator! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on January 31, 2026.

🧑‍💻 @tali-creator: Please resolve the issue such that the repo's maintainers have enough time to review your contribution before the due date. You'll earn Points for completing the issue on-time, which will make you eligible for a share of the Stellar Wave Program's reward pool.

Warning

When opening a PR, please link it to this issue to ensure it gets tracked accurately. Points are issued when this issue is marked as completed by the maintainer.

🤠 Repo maintainers: Please keep an eye on the contributor's progress and review their work before the due date. You can manage this issue, including adjusting its complexity and points, here.

🌊 Happy Wave 🌊