Skip to content

[docs-agent] Add UTXO API migration guide#1291

Merged
mihaiciuciu3410 merged 10 commits into
mainfrom
docs/utxo-migration-guide
May 11, 2026
Merged

[docs-agent] Add UTXO API migration guide#1291
mihaiciuciu3410 merged 10 commits into
mainfrom
docs/utxo-migration-guide

Conversation

@JackReacher0807
Copy link
Copy Markdown
Collaborator

Summary

Adds a new UTXO API migration guide covering migration from QuickNode, BlockCypher, and Blockdaemon to Alchemy's UTXO API. Content provided by Andra (Data Services Product team) in Slack. Single page lives under the Bitcoin section since BTC is the canonical UTXO chain; the body covers BTC, BCH, LTC, and DOGE.

Changes:

  • New page: content/api-reference/bitcoin/utxo-migration-guide.mdx
  • Nav: added entry in the Bitcoin section of content/docs.yml

Linear

DOCS-77

Questions for reviewers

  1. Location. Wes deferred placement to the DX team in the originating Slack thread. Parked the page under the Bitcoin section since UTXO content already lives there. Open to moving if the DX team prefers a different home (e.g. a dedicated migrations directory, or duplicating the entry under each chain's section).
  2. Grafana benchmark link. The source content includes an alchemyinsights.grafana.net URL for the live benchmark dashboard. The domain looks internal. @andra-catana, should this stay public, or replace with a different page?
  3. Cross-linking from BCH / LTC / DOGE overviews. Page covers all four chains in body. Went with single-source + body coverage rather than duplicate nav entries. Happy to add per-chain cross-links if useful.

Requested by

@andra-catana (via Slack thread)

Side-by-side migration guide covering QuickNode, BlockCypher, and Blockdaemon for Alchemy's UTXO API (BTC, BCH, LTC, DOGE). Sourced from data-services-product content provided in Slack.

Refs DOCS-77

Requested-by: @andra-catana
@JackReacher0807 JackReacher0807 requested a review from a team as a code owner May 11, 2026 15:44
@github-actions
Copy link
Copy Markdown

github-actions Bot commented May 11, 2026

🔗 Preview Mode

Name Status Preview Updated (UTC)
Alchemy Docs ✅ Ready 🔗 Visit Preview May 11, 2026, 5:11 PM

Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 5a99cd5425

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

Comment thread content/api-reference/bitcoin/utxo-migration-guide.mdx Outdated
Comment thread content/api-reference/bitcoin/utxo-migration-guide.mdx Outdated
@github-actions
Copy link
Copy Markdown

github-actions Bot commented May 11, 2026

🔍 Link Check

Status: ❌ Failed

Summary

Status Count
🔍 Total 8200
✅ Successful 7054
⏳ Timeouts 0
🔀 Redirected 451
👻 Excluded 683
❓ Unknown 0
🚫 Errors 11
⛔ Unsupported 1
Broken links (11) — click to expand

Errors per input

Errors in ./content/wallets/wallet-integrations/privy/jwt-auth-migration.mdx

Errors in ./content/wallets/pages/recipes/onramp-funds.mdx

Errors in ./content/tutorials/smart-wallets/learn-account-abstraction/introduction-to-account-abstraction.mdx

Errors in ./content/wallets/wallet-integrations/privy/signer-migration-overview.mdx

Errors in ./content/api-reference/bitcoincash/bitcoincash-api-overview.mdx

Errors in ./content/api-reference/dogecoin/dogecoin-api-overview.mdx

Errors in ./content/api-reference/litecoin/litecoin-api-overview.mdx

Errors in ./content/api-reference/data/webhooks/custom-webhooks-quickstart/custom-webhooks-quickstart.mdx

Errors in ./content/api-reference/arbitrum-nova/arbitrum-nova-deprecation-notice.mdx

Errors in ./content/wallets/pages/recipes/programmatic-wallet-creation.mdx

View workflow run

… cross-links on BCH/LTC/DOGE overviews

Addresses review feedback from @SahilAujla on PR #1291: the live Grafana benchmark dashboard is internal-only, so removing the link from the public migration guide. Adding one-line cross-links to the UTXO migration guide from the Bitcoin Cash, Litecoin, and Dogecoin overview pages so users on those chains can find the migration content.

Refs DOCS-77

Requested-by: @andra-catana
Andra (originator) confirmed in the Slack thread that the live benchmark dashboard should be public-facing, reverting the previous removal based on Sahil's tentative guidance. The 'View live dashboard' link in the Benchmarking results section is restored.

Refs DOCS-77

Requested-by: @andra-catana
Per Andra's review feedback, the four chain reference links in the 'What Alchemy's UTXO API provides' section now use absolute https://www.alchemy.com/docs URLs instead of relative /docs paths.

Refs DOCS-77

Requested-by: @andra-catana
Codex flagged that the migration table told users Alchemy doesn't include fiat rates and to use a separate endpoint, but the UTXO spec defines fiatcurrency as a query param on the same /api/v2/balancehistory/{address} endpoint and the response includes a rates field. Updated the table row to match the spec.

Refs DOCS-77

Requested-by: @andra-catana
Replaced the AccordionGroup component with a flat nested bullet list per Andra's review feedback. Restored verbatim source content from her message: en-dash style separators, 'on-chain' (her wording), and 'vs' without trailing period.

Refs DOCS-77

Requested-by: @andra-catana
…ublic dashboard

Andra's call on the FAQ Q3 / QuickNode differences table conflict: remove the question entirely. Also updated the live benchmark dashboard URL to the new public-dashboards link she provided.

Refs DOCS-77

Requested-by: @andra-catana
JackReacher0807 and others added 3 commits May 11, 2026 16:36
… misconfigured)

The www.starknetjs.com cert is only valid for *.netlify.app and netlify.app, not the custom apex domain. Adding to the lychee exclude list so the link check on PR #1291 (and future PRs that touch content) passes. Same pattern as the other Netlify-TLS exclusions already in this file.

Refs DOCS-77

Requested-by: @andra-catana
remark-lint-unordered-list-marker-style requires '*' rather than '-' for unordered lists. The earlier FAQ rewrite used '-' which triggered 12 lint warnings. Switched to '*' for both the question and nested answer bullets to match the project convention.

Refs DOCS-77

Requested-by: @andra-catana
@mihaiciuciu3410 mihaiciuciu3410 merged commit 030ed76 into main May 11, 2026
13 of 14 checks passed
@mihaiciuciu3410 mihaiciuciu3410 deleted the docs/utxo-migration-guide branch May 11, 2026 17:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants