Skip to content

Conversation

@joaquim-verges
Copy link
Member

@joaquim-verges joaquim-verges commented Nov 9, 2025


PR-Codex overview

This PR focuses on replacing the celoAlfajoresTestnet with celoSepoliaTestnet in the codebase, updating the relevant definitions and exports.

Detailed summary

  • Deleted the file celo-alfajores-testnet.ts.changeset/shaky-dragons-check.md.
  • Added a new chain definition for celoSepoliaTestnet in celo-sepolia-testnet.ts.
  • Updated exports/chains.ts to export celoSepoliaTestnet instead of celoAlfajoresTestnet.

✨ Ask PR-Codex anything about this PR by commenting with /codex {your question}

Summary by CodeRabbit

  • Updates
    • Replaced Celo Alfajores Testnet with Celo Sepolia Testnet support in the SDK.

@vercel
Copy link

vercel bot commented Nov 9, 2025

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Preview Comments Updated (UTC)
docs-v2 Ready Ready Preview Comment Nov 9, 2025 10:11pm
nebula Ready Ready Preview Comment Nov 9, 2025 10:11pm
thirdweb_playground Ready Ready Preview Comment Nov 9, 2025 10:11pm
thirdweb-www Ready Ready Preview Comment Nov 9, 2025 10:11pm
wallet-ui Ready Ready Preview Comment Nov 9, 2025 10:11pm

@changeset-bot
Copy link

changeset-bot bot commented Nov 9, 2025

🦋 Changeset detected

Latest commit: 3ba3e8f

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 4 packages
Name Type
thirdweb Patch
@thirdweb-dev/nebula Patch
@thirdweb-dev/wagmi-adapter Patch
wagmi-inapp Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@github-actions github-actions bot added packages SDK Involves changes to the thirdweb SDK labels Nov 9, 2025
Copy link
Member Author


How to use the Graphite Merge Queue

Add either label to this PR to merge it via the merge queue:

  • merge-queue - adds this PR to the back of the merge queue
  • hotfix - for urgent hot fixes, skip the queue and merge this PR next

You must have a Graphite account in order to use the merge queue. Sign up using this link.

An organization admin has enabled the Graphite Merge Queue in this repository.

Please do not merge from GitHub as this will restart CI on PRs being processed by the merge queue.

This stack of pull requests is managed by Graphite. Learn more about stacking.

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Nov 9, 2025

Walkthrough

Replaces Celo Alfajores Testnet with Celo Sepolia Testnet as the supported test network. The old chain definition is removed, a new one is added with updated metadata, and the public export is updated to reference the new chain definition.

Changes

Cohort / File(s) Change Summary
Chain Definition Removal
packages/thirdweb/src/chains/chain-definitions/celo-alfajores-testnet.ts
Deleted the exported celoAlfajoresTestnet constant and removed the defineChain import.
Chain Definition Addition
packages/thirdweb/src/chains/chain-definitions/celo-sepolia-testnet.ts
Added new exported celoSepoliaTestnet constant with Celo Sepolia Testnet metadata (chain ID 11142220, block explorer URL, native currency configuration).
Public Export Update
packages/thirdweb/src/exports/chains.ts
Replaced exported symbol from celoAlfajoresTestnet to celoSepoliaTestnet, updating the import path accordingly.
Changeset
.changeset/shaky-dragons-check.md
Added changeset entry documenting patch release for thirdweb package with network reference update.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

  • Verify the new Celo Sepolia chain ID (11142220) and block explorer URL are accurate
  • Confirm no other references to celoAlfajoresTestnet remain in the codebase
  • Validate the native currency configuration (CELO-S symbol with 18 decimals)

Pre-merge checks and finishing touches

❌ Failed checks (1 warning)
Check name Status Explanation Resolution
Description check ⚠️ Warning The PR description is largely incomplete, missing required template sections like issue tag, Notes for the reviewer, and How to test instructions. Add the missing template sections: include Linear issue tag (TEAM-0000 format), provide reviewer notes explaining the migration rationale, and include testing instructions for the chain definition changes.
✅ Passed checks (2 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly and specifically describes the main change: replacing Celo Alfajores Testnet with Celo Sepolia Testnet, which matches the changeset modifications.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
✨ Finishing touches
  • 📝 Generate docstrings
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch Replace_Celo_Alfajores_with_Celo_Sepolia_Testnet

Warning

Review ran into problems

🔥 Problems

Errors were encountered while retrieving linked issues.

Errors (1)
  • TEAM-0000: Entity not found: Issue - Could not find referenced Issue.

Comment @coderabbitai help to get the list of available commands and usage tips.

@joaquim-verges joaquim-verges changed the title Replace Celo Alfajores with Celo Sepolia Testnet [SDK] Replace Celo Alfajores with Celo Sepolia Testnet Nov 9, 2025
@joaquim-verges joaquim-verges marked this pull request as ready for review November 9, 2025 21:58
@joaquim-verges joaquim-verges requested review from a team as code owners November 9, 2025 21:58
Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 1

🧹 Nitpick comments (1)
.changeset/shaky-dragons-check.md (1)

1-5: Consider using "minor" version bump instead of "patch".

This change removes the public export celoAlfajoresTestnet and adds a new public export celoSepoliaTestnet, which constitutes a modification to the public API surface. As per coding guidelines, modified public API should use a "minor" version bump rather than "patch".

Based on coding guidelines.

Apply this diff:

 ---
-"thirdweb": patch
+"thirdweb": minor
 ---
 
 Replace celo alfajores with celoSepoliaTestnet
📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

Disabled knowledge base sources:

  • Linear integration is disabled by default for public repositories

You can enable these sources in your CodeRabbit configuration.

📥 Commits

Reviewing files that changed from the base of the PR and between 282edf7 and 3ba3e8f.

📒 Files selected for processing (4)
  • .changeset/shaky-dragons-check.md (1 hunks)
  • packages/thirdweb/src/chains/chain-definitions/celo-alfajores-testnet.ts (0 hunks)
  • packages/thirdweb/src/chains/chain-definitions/celo-sepolia-testnet.ts (1 hunks)
  • packages/thirdweb/src/exports/chains.ts (1 hunks)
💤 Files with no reviewable changes (1)
  • packages/thirdweb/src/chains/chain-definitions/celo-alfajores-testnet.ts
🧰 Additional context used
📓 Path-based instructions (5)
**/*.{ts,tsx}

📄 CodeRabbit inference engine (CLAUDE.md)

**/*.{ts,tsx}: Write idiomatic TypeScript with explicit function declarations and return types
Limit each file to one stateless, single-responsibility function for clarity
Re-use shared types from @/types or local types.ts barrels
Prefer type aliases over interface except for nominal shapes
Avoid any and unknown unless unavoidable; narrow generics when possible
Choose composition over inheritance; leverage utility types (Partial, Pick, etc.)
Comment only ambiguous logic; avoid restating TypeScript in prose

**/*.{ts,tsx}: Use explicit function declarations and explicit return types in TypeScript
Limit each file to one stateless, single‑responsibility function
Re‑use shared types from @/types where applicable
Prefer type aliases over interface except for nominal shapes
Avoid any and unknown unless unavoidable; narrow generics when possible
Prefer composition over inheritance; use utility types (Partial, Pick, etc.)
Lazy‑import optional features and avoid top‑level side‑effects to reduce bundle size

Files:

  • packages/thirdweb/src/chains/chain-definitions/celo-sepolia-testnet.ts
  • packages/thirdweb/src/exports/chains.ts
**/*.{ts,tsx,js,jsx}

📄 CodeRabbit inference engine (CLAUDE.md)

Load heavy dependencies inside async paths to keep initial bundle lean (lazy loading)

Files:

  • packages/thirdweb/src/chains/chain-definitions/celo-sepolia-testnet.ts
  • packages/thirdweb/src/exports/chains.ts
packages/thirdweb/**/*.{ts,tsx}

📄 CodeRabbit inference engine (AGENTS.md)

packages/thirdweb/**/*.{ts,tsx}: Every public symbol must have comprehensive TSDoc with at least one compiling @example and a custom tag (@beta, @internal, @experimental, etc.)
Comment only ambiguous logic; avoid restating TypeScript in prose
Lazy‑load heavy dependencies inside async paths (e.g., const { jsPDF } = await import("jspdf"))

Files:

  • packages/thirdweb/src/chains/chain-definitions/celo-sepolia-testnet.ts
  • packages/thirdweb/src/exports/chains.ts
packages/thirdweb/src/exports/**

📄 CodeRabbit inference engine (CLAUDE.md)

packages/thirdweb/src/exports/**: Export everything via exports/ directory, grouped by feature in the SDK public API
Every public symbol must have comprehensive TSDoc with at least one @example block that compiles and custom annotation tags (@beta, @internal, @experimental)

Files:

  • packages/thirdweb/src/exports/chains.ts
.changeset/*.md

📄 CodeRabbit inference engine (AGENTS.md)

.changeset/*.md: Each change in packages/* must include a changeset for the appropriate package
Version bump rules: patch for non‑API changes; minor for new/modified public API

Files:

  • .changeset/shaky-dragons-check.md
🧠 Learnings (6)
📚 Learning: 2025-07-18T19:19:55.613Z
Learnt from: CR
Repo: thirdweb-dev/js PR: 0
File: CLAUDE.md:0-0
Timestamp: 2025-07-18T19:19:55.613Z
Learning: Applies to **/*.test.{ts,tsx} : Use `FORKED_ETHEREUM_CHAIN` for mainnet interactions and `ANVIL_CHAIN` for isolated tests

Applied to files:

  • packages/thirdweb/src/chains/chain-definitions/celo-sepolia-testnet.ts
  • packages/thirdweb/src/exports/chains.ts
📚 Learning: 2025-07-18T19:19:55.613Z
Learnt from: CR
Repo: thirdweb-dev/js PR: 0
File: CLAUDE.md:0-0
Timestamp: 2025-07-18T19:19:55.613Z
Learning: Applies to test/src/test-wallets.ts : Predefined test accounts are in `test/src/test-wallets.ts`

Applied to files:

  • packages/thirdweb/src/chains/chain-definitions/celo-sepolia-testnet.ts
  • packages/thirdweb/src/exports/chains.ts
📚 Learning: 2025-06-06T23:46:08.795Z
Learnt from: MananTank
Repo: thirdweb-dev/js PR: 7298
File: apps/dashboard/src/app/nebula-app/move-funds/move-funds.tsx:424-424
Timestamp: 2025-06-06T23:46:08.795Z
Learning: The thirdweb project has an ESLint rule that restricts direct usage of `defineChain`. When it's necessary to use `defineChain` directly, it's acceptable to disable the rule with `// eslint-disable-next-line no-restricted-syntax`.

Applied to files:

  • packages/thirdweb/src/chains/chain-definitions/celo-sepolia-testnet.ts
📚 Learning: 2025-08-29T15:37:38.513Z
Learnt from: CR
Repo: thirdweb-dev/js PR: 0
File: AGENTS.md:0-0
Timestamp: 2025-08-29T15:37:38.513Z
Learning: Applies to packages/thirdweb/exports/** : Export all public API via `packages/thirdweb/exports/`, grouped by feature

Applied to files:

  • packages/thirdweb/src/exports/chains.ts
📚 Learning: 2025-08-29T15:37:38.513Z
Learnt from: CR
Repo: thirdweb-dev/js PR: 0
File: AGENTS.md:0-0
Timestamp: 2025-08-29T15:37:38.513Z
Learning: Applies to .changeset/*.md : Version bump rules: patch for non‑API changes; minor for new/modified public API

Applied to files:

  • .changeset/shaky-dragons-check.md
📚 Learning: 2025-08-29T15:37:38.513Z
Learnt from: CR
Repo: thirdweb-dev/js PR: 0
File: AGENTS.md:0-0
Timestamp: 2025-08-29T15:37:38.513Z
Learning: Applies to .changeset/*.md : Each change in `packages/*` must include a changeset for the appropriate package

Applied to files:

  • .changeset/shaky-dragons-check.md
🧬 Code graph analysis (1)
packages/thirdweb/src/chains/chain-definitions/celo-sepolia-testnet.ts (1)
packages/thirdweb/src/exports/chains.ts (2)
  • celoSepoliaTestnet (27-27)
  • defineChain (92-92)
⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (8)
  • GitHub Check: E2E Tests (pnpm, esbuild)
  • GitHub Check: E2E Tests (pnpm, vite)
  • GitHub Check: E2E Tests (pnpm, webpack)
  • GitHub Check: Lint Packages
  • GitHub Check: Size
  • GitHub Check: Unit Tests
  • GitHub Check: Build Packages
  • GitHub Check: Analyze (javascript)
🔇 Additional comments (2)
packages/thirdweb/src/exports/chains.ts (1)

27-27: All references to celoAlfajoresTestnet have been successfully updated.

Verification confirms zero remaining references to the old export name in active source code. The migration to celoSepoliaTestnet is complete—only a historical CHANGELOG entry documents the original Alfajores testnet addition, which requires no action.

packages/thirdweb/src/chains/chain-definitions/celo-sepolia-testnet.ts (1)

6-17: I need to verify the native currency symbol. Let me search for that information.

Based on the verification results:

Chain metadata for Celo Sepolia Testnet is accurate.

The chain ID 11142220 is confirmed, and the block explorer URL https://celo-sepolia.blockscout.com is correct.

Regarding the native currency symbol "CELO-S": Celo Sepolia Testnet uses CELO-S as the gas token, which aligns with thirdweb's product documentation. While official Celo MetaMask setup documentation shows "CELO", thirdweb uses "CELO-S" to distinguish the testnet token, which is consistent with thirdweb's platform.

All metadata in the code is accurate.

Comment on lines +3 to +17
/**
* @chain
*/
export const celoSepoliaTestnet = /* @__PURE__ */ defineChain({
blockExplorers: [
{
name: "Celo Sepolia Explorer",
url: "https://celo-sepolia.blockscout.com/",
},
],
id: 11142220,
name: "Celo Sepolia Testnet",
nativeCurrency: { decimals: 18, name: "CELO", symbol: "CELO-S" },
testnet: true,
});
Copy link
Contributor

Choose a reason for hiding this comment

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

🛠️ Refactor suggestion | 🟠 Major

Add comprehensive TSDoc documentation with example and custom tags.

The public export celoSepoliaTestnet is missing comprehensive TSDoc as required by the coding guidelines. Public symbols must include a description, at least one compiling @example block, and a custom annotation tag.

Based on coding guidelines.

Apply this diff:

 /**
+ * The Celo Sepolia Testnet chain.
+ *
+ * @example
+ * ```ts
+ * import { celoSepoliaTestnet } from "thirdweb/chains";
+ * const tx = await sendTransaction({
+ *   to: "0x...",
+ *   chain: celoSepoliaTestnet,
+ * });
+ * ```
+ * 
  * @chain
+ * @beta
  */

@github-actions
Copy link
Contributor

github-actions bot commented Nov 9, 2025

size-limit report 📦

Path Size
@thirdweb-dev/nexus (esm) 104.88 KB (0%)
@thirdweb-dev/nexus (cjs) 316.6 KB (0%)

@joaquim-verges joaquim-verges merged commit 673e51b into main Nov 9, 2025
22 of 23 checks passed
@joaquim-verges joaquim-verges deleted the Replace_Celo_Alfajores_with_Celo_Sepolia_Testnet branch November 9, 2025 22:46
@joaquim-verges joaquim-verges mentioned this pull request Nov 9, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

packages SDK Involves changes to the thirdweb SDK

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants