Add Go examples to the archival, conventions, rpc, conversions and events guides - #3124

🤖 Automated message from the Stellar Triage Bot.

Refs #1770

Working this because @ElliotFriend approved the Go and Java splits in #1770 and asked me to keep building the stack. This is Go B: Go tabs on the other 14 build/guides pages. Base: #3123 (docs-agent/1770-go-a). Go C, Go D and Java A to D follow.

What changed

• A Go tab next to every Stellar SDK example on these 14 pages:
  • archival/: create-restoration-footprint, extend-persistent-entry, restore-contract, restore-data
  • conventions/: deploy-sac-with-code, extending-wasm-ttl
  • rpc/: generate-ledger-keys, retrieve-contract-code
  • conversions/: address-conversions, bytes-conversions, scval-conversions, string-conversions
  • events/: consume, ingest
• Tab order is JavaScript, Python, Go. Three pages had another order, so I moved tabs:
  • bytes-conversions and string-conversions: Rust moved from first to last.
  • ingest: JavaScript moved before Python.
• Every transaction bids the capped fee-stats p90, like the other tabs.
• The Go SDK has no prepareTransaction. Where a page needs one, the Go tab defines a small helper and says so in one line. restore-data defines assembleTransaction for the same reason.
• restore-contract and restore-data reuse the Go submitTx from submit-transaction-wait (Add Go examples to the transactions and basics guides #3123).
• Prose changed only where it named JavaScript and Python alone.

A choice to confirm

• The events pages need a database library. The Go tabs use GORM with gorm.io/driver/sqlite, the Go match for Prisma and SQLAlchemy. That driver needs cgo. Tell me if you prefer database/sql instead.
• The Go storeEvents skips events already stored (OnConflict{DoNothing: true}). Each run starts again at the latest ingested ledger, so that ledger's events come back.

Skipped

• dapps/state-archival: browser code only, as agreed in Standardize on the languages of the examples throughout the Guides section #1770.
• Rust-only sections (BytesN to Fixed-Size Array, the contract TTL code) and the CLI tab.

Why this matters

Go readers had no example on these 14 pages. @ElliotFriend chose all four languages on every page in #1770.

Sweep

Not a claim fix, so no sweep. I checked the prose next to each new tab for text that named only JavaScript or Python, and updated it.

Verified

• Every Go symbol, field and type against go-stellar-sdk v0.9.0, the newest release: clients/rpcclient/main.go, protocols/rpc/{get_events,get_ledger_entries,simulate_transaction,send_transaction,get_transaction,get_fee_stats,get_health}.go, txnbuild/{transaction,extend_footprint_ttl,restore_footprint,invoke_host_function,asset}.go, xdr/{xdr_generated,ledger_key,scval,account_id}.go, strkey/main.go. The pages pin no Go SDK version.
• txnbuild.NewTransaction adds SorobanData.ResourceFee to the fee (transaction.go:902-926). So restore-data does not add minResourceFee by hand, unlike the JavaScript tab.
• xdr.ScVal.String() prints a symbol as its text, an address as its strkey and an i32 as a number (scval.go:249-327). That gives the listener output on consume.
• SegmentFilter.UnmarshalJSON takes * or a base64 ScVal (get_events.go:386-404), so ingest decodes the topic filter from the same JSON as the other tabs.
• GORM v1.31.2: AfterCreate(*gorm.DB) error hook (callbacks/interfaces.go:9), clause.OnConflict.DoNothing, logger.LogMode. gorm.io/driver/sqlite v1.6.0 imports mattn/go-sqlite3 (cgo).
• pnpm check passes: prettier, mint validate, no broken links.

Not verified

• The Go code did not compile or run. go needs approval in this lane. A maintainer runs the Go blocks before merge, as @ElliotFriend said on Add Go examples to the transactions and basics guides #3123.
• CI may not run until the base is main (stacked PR).

Overlaps

• Stacked on Add Go examples to the transactions and basics guides #3123, which is stacked on Add Python examples to the guides and learn pages that lacked them #3115. Add Python examples to the guides and learn pages that lacked them #3115 edits 6 of these 14 pages. Merge Add Python examples to the guides and learn pages that lacked them #3115, then Add Go examples to the transactions and basics guides #3123, then this PR.
• Older community PRs also edit consume, ingest and the archival pages (🎨 Clean up images, imports #2231, 📝 Refresh six classic guides #723). Neither adds Go.

Found in passing, not fixed here

Defects in existing code on these pages. #3119 collects such defects, but it carries bot:hands-off, so I did not post there. A maintainer can move these to it.

1. conversions/bytes-conversions.mdx L23 and L26 (JavaScript): const addressFromBytes is declared twice in one block, a SyntaxError.
2. events/ingest.mdx (JavaScript):
   • L210: latestEventIngested is null on an empty database, so .ledger throws.
   • L342: forEach(async ...) does not wait for the writes.
   • L348: event.contractId! is TypeScript syntax in a javascript block.
3. events/ingest.mdx L238 (Python): uses contract_id before L251 defines it.