fix: migrate balance and nonce api calls from v1 to v3

[rafa-stacks]

Migrates deprecated /extended/v1 Stacks API endpoints to their /extended/v3 replacements:

• /extended/v1/address/{address}/balances → /extended/v3/principals/{principal}/balances/stx
• /extended/v1/address/{address}/nonces → /extended/v3/principals/{principal}/nonces

[codecov-commenter]

Codecov Report

❌ Patch coverage is 50.00000% with 10 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
packages/api/src/api.ts	0.00%	8 Missing ⚠️
packages/cli/src/cli.ts	80.00%	2 Missing ⚠️

📢 Thoughts on this report? Let us know!

[Copilot]

Pull request overview

Migrates deprecated balance and nonce API calls from v1 to v3 across the SDK.

Changes:

• Updates nonce fetching to use the v3 principal endpoint.
• Migrates STX balance responses and bigint conversions to the v3 shape.
• Updates CLI consumers, tests, documentation, and release metadata.

Reviewed changes

Copilot reviewed 10 out of 10 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
packages/transactions/tests/builder.test.ts	Updates the nonce response fixture.
packages/transactions/src/fetch.ts	Migrates nonce fetching to v3.
packages/stacking/src/index.ts	Migrates balances and response types to v3.
packages/stacking/README.md	Documents the new balance shape.
packages/cli/tests/cli.test.ts	Updates the CLI balance fixture.
packages/cli/src/cli.ts	Uses StackingClient for balance requests.
packages/api/src/types.ts	Defines v3 balance response types.
packages/api/src/api.ts	Migrates balance fetching to v3.
.changeset/shiny-moons-attend.md	Records the transactions change.
.changeset/lucky-buses-repeat.md	Records balance API changes.

Suppressed comments (1)

packages/cli/src/cli.ts:1746

• Use available for this spendability check. With locked or pending STX, balance can exceed available, causing the CLI to proceed and submit a stack transaction for funds that cannot be locked; the transaction then fails instead of producing the intended local balance error.

      const balanceBN = balance.balance;

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[Copilot]

🟡 Changes recommended

The stacking package still exposes a production path that calls the deprecated v1 balance endpoint.

Get a fresh assessment by requesting another Copilot review.

Review details

• Files reviewed: 40/40 changed files
• Comments generated: 2
• Review effort level: Balanced