Skip to content

docs(chain-fusion): add missing Learn Hub images and architecture diagrams#229

Merged
marc0olo merged 1 commit intoinfra/learn-hub-migration-prepfrom
docs/chain-fusion-images
May 9, 2026
Merged

docs(chain-fusion): add missing Learn Hub images and architecture diagrams#229
marc0olo merged 1 commit intoinfra/learn-hub-migration-prepfrom
docs/chain-fusion-images

Conversation

@marc0olo
Copy link
Copy Markdown
Member

@marc0olo marc0olo commented May 9, 2026

Closes #223.

Summary

Adds all images and diagrams that were not carried over when PR #213 migrated the chain fusion concept pages. Every image was individually evaluated; three were skipped (see below).

Raster images added (sourced from Learn Hub)

  • bitcoin.md: full-stack integration architecture (adapter + protocol layers + Bitcoin canister); ckBTC system architecture (minter, ledger, Bitcoin canister, checker canister with labeled data flows); Bitcoin checker canister OFAC screening flow
  • dogecoin.md: Dogecoin adapter + canister + protocol-stack architecture diagram
  • exchange-rate-canister.md: XRC data-flow diagram (forex providers + exchanges → XRC → requesting canister)

PlantUML diagrams added (source-controlled, new)

  • bitcoin.md: Bitcoin canister API spending-flow sequence (bitcoin_get_utxossign_with_ecdsa per input → bitcoin_send_transaction)
  • ethereum.md: EVM RPC component architecture (Internet Computer | JSON-RPC Providers | Ethereum) — recreated instead of using the Learn Hub raster, which had "Web 2.0" as a zone label (banned term)
  • solana.md: SOL RPC component architecture (Internet Computer | JSON-RPC Providers | Solana) — same reason; also complements the existing call-flow sequence diagrams already in this file

Skipped

  • Ethereum marketing render (34575033443348): promotional 3D rendering, not a technical diagram; inconsistent with the clean diagram style used elsewhere
  • ckBTC retrieval sequence (44598026440340): the flow it depicts is already expressed in the existing PlantUML in bitcoin.md
  • SNS supply-demand chart (34146812547476): generic economics textbook diagram with no ICP-specific content

Sync recommendation

informed by Learn Hub articles "Bitcoin Integration", "Bitcoin Checker Canister", "Chain-Key Bitcoin", "Dogecoin Integration", "Exchange Rate Canister", "EVM RPC Canister", "SOL RPC Canister" (migrated, source retired)

…grams

Resolves #223. Adds the images and diagrams that were not carried over
when PR #213 migrated the chain fusion concept pages.

Raster images (sourced from Learn Hub, downloaded and committed):
- bitcoin.md: full-stack integration architecture, ckBTC system
  architecture (minter/ledger/Bitcoin canister/checker), Bitcoin checker
  canister OFAC flow
- dogecoin.md: Dogecoin adapter + canister + protocol-stack architecture
- exchange-rate-canister.md: XRC data-flow (forex providers + exchanges
  → XRC → requesting canister)

PlantUML diagrams (new, source-controlled):
- bitcoin.md: Bitcoin canister API spending flow sequence
  (bitcoin_get_utxos → sign_with_ecdsa per input → bitcoin_send_transaction)
- ethereum.md: EVM RPC component architecture (ICP | JSON-RPC Providers
  | Ethereum), replacing the Learn Hub raster that used the banned term
  "Web 2.0" as a zone label
- solana.md: SOL RPC component architecture (ICP | JSON-RPC Providers
  | Solana), same reason

Skipped: Ethereum marketing 3D render (promotional, not technical);
ckBTC retrieval sequence (already expressed in existing PlantUML);
SNS supply-demand chart (generic economics diagram, no ICP content).
@marc0olo marc0olo requested a review from a team as a code owner May 9, 2026 09:16
@marc0olo marc0olo merged commit 068d38a into infra/learn-hub-migration-prep May 9, 2026
3 checks passed
@marc0olo marc0olo deleted the docs/chain-fusion-images branch May 9, 2026 09:30
marc0olo added a commit that referenced this pull request May 11, 2026
…grams (#229)

Closes #223.

## Summary

Adds all images and diagrams that were not carried over when PR #213
migrated the chain fusion concept pages. Every image was individually
evaluated; three were skipped (see below).

### Raster images added (sourced from Learn Hub)

- **`bitcoin.md`**: full-stack integration architecture (adapter +
protocol layers + Bitcoin canister); ckBTC system architecture (minter,
ledger, Bitcoin canister, checker canister with labeled data flows);
Bitcoin checker canister OFAC screening flow
- **`dogecoin.md`**: Dogecoin adapter + canister + protocol-stack
architecture diagram
- **`exchange-rate-canister.md`**: XRC data-flow diagram (forex
providers + exchanges → XRC → requesting canister)

### PlantUML diagrams added (source-controlled, new)

- **`bitcoin.md`**: Bitcoin canister API spending-flow sequence
(`bitcoin_get_utxos` → `sign_with_ecdsa` per input →
`bitcoin_send_transaction`)
- **`ethereum.md`**: EVM RPC component architecture (Internet Computer |
JSON-RPC Providers | Ethereum) — recreated instead of using the Learn
Hub raster, which had "Web 2.0" as a zone label (banned term)
- **`solana.md`**: SOL RPC component architecture (Internet Computer |
JSON-RPC Providers | Solana) — same reason; also complements the
existing call-flow sequence diagrams already in this file

### Skipped

- **Ethereum marketing render** (`34575033443348`): promotional 3D
rendering, not a technical diagram; inconsistent with the clean diagram
style used elsewhere
- **ckBTC retrieval sequence** (`44598026440340`): the flow it depicts
is already expressed in the existing PlantUML in `bitcoin.md`
- **SNS supply-demand chart** (`34146812547476`): generic economics
textbook diagram with no ICP-specific content

## Sync recommendation

`informed by Learn Hub articles "Bitcoin Integration", "Bitcoin Checker
Canister", "Chain-Key Bitcoin", "Dogecoin Integration", "Exchange Rate
Canister", "EVM RPC Canister", "SOL RPC Canister" (migrated, source
retired)`
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.

1 participant