Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
18 commits
Select commit Hold shift + click to select a range
e9b5bf0
docs: restructure testnets to separate active from deprecated networks
Earnwithalee7890 Jan 23, 2026
ddf50ce
Update iframe-theme.js to improve documentation coverage
Earnwithalee7890 Jan 24, 2026
de7bb89
Update filtering-an-array-sbs.mdx to improve documentation coverage
Earnwithalee7890 Jan 24, 2026
c241fd4
Update account-abstraction-on-base-using-privy-and-the-base-paymaster…
Earnwithalee7890 Jan 24, 2026
71d0ef7
Update introduction-to-providers.mdx to improve documentation coverage
Earnwithalee7890 Jan 24, 2026
917729e
Update useReadContract.mdx to improve documentation coverage
Earnwithalee7890 Jan 24, 2026
78281ae
Update useSimulateContract.mdx to improve documentation coverage
Earnwithalee7890 Jan 24, 2026
e132a3d
Update erc-721-sbs.mdx to improve documentation coverage
Earnwithalee7890 Jan 24, 2026
a5aaceb
Update complex-onchain-nfts.mdx to improve documentation coverage
Earnwithalee7890 Jan 24, 2026
cb6ed56
Update signature-mint.mdx to improve documentation coverage
Earnwithalee7890 Jan 24, 2026
5257f5a
Update simple-onchain-nfts.mdx to improve documentation coverage
Earnwithalee7890 Jan 24, 2026
c6c1efa
Update thirdweb-unreal-nft-items.mdx to improve documentation coverage
Earnwithalee7890 Jan 24, 2026
cf0f8ff
Update overview.mdx to improve documentation coverage
Earnwithalee7890 Jan 24, 2026
4f4a036
Update quality-bar.mdx to improve documentation coverage
Earnwithalee7890 Jan 24, 2026
6f87064
Update submission-guidelines.mdx to improve documentation coverage
Earnwithalee7890 Jan 24, 2026
3c1d78c
Update error-handling.mdx to improve documentation coverage
Earnwithalee7890 Jan 24, 2026
d8ce5ec
Merge branch 'base:master' into master
Earnwithalee7890 Jan 24, 2026
6a34654
style(docs): standardize 'dApp' to 'dapp'
Earnwithalee7890 Jan 30, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ description: "Connect wallet and request account access"
Custom Coinbase Wallet method for establishing connection

<Info>
Requests that the wallet connects to the dApp and provides account access. This is similar to `eth_requestAccounts` but provides additional connection features.
Requests that the wallet connects to the dapp and provides account access. This is similar to `eth_requestAccounts` but provides additional connection features.
</Info>

## Parameters
Expand Down
2 changes: 1 addition & 1 deletion docs/base-chain/tools/data-indexers.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -77,7 +77,7 @@ To get started, visit the [documentation](https://docs.envio.dev/docs/overview)

[GhostGraph](https://ghostgraph.xyz/) makes it easy to build blazingly fast indexers (subgraphs) for smart contracts.

GhostGraph is the first indexing solution that lets you write your index transformations in **Solidity**. Base dApps can query data with GraphQL using our hosted endpoints.
GhostGraph is the first indexing solution that lets you write your index transformations in **Solidity**. Base dapps can query data with GraphQL using our hosted endpoints.

To get started, you can [sign up for an account](https://app.ghostlogs.xyz/ghostgraph/sign-up) and follow [this quickstart](https://docs.ghostlogs.xyz/category/-getting-started-1) guide on how to create, deploy, and query a GhostGraph.

Expand Down
2 changes: 1 addition & 1 deletion docs/base-chain/tools/oracles.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ The API3 Market provides access to 200+ price feeds on [Base Mainnet](https://ma

The price feeds are delivered by an aggregate of [first-party oracles](https://docs.api3.org/explore/airnode/why-first-party-oracles.html) using signed data and support [OEV recapture](https://docs.api3.org/explore/introduction/oracle-extractable-value.html).

Unlike traditional data feeds, reading [API3 price feeds](https://docs.api3.org/guides/dapis/) enables dApps to auction off the right to update the price feeds to searcher bots which facilitates more efficient liquidation processes for users and LPs of DeFi money markets. The OEV recaptured is returned to the dApp.
Unlike traditional data feeds, reading [API3 price feeds](https://docs.api3.org/guides/dapis/) enables dapps to auction off the right to update the price feeds to searcher bots which facilitates more efficient liquidation processes for users and LPs of DeFi money markets. The OEV recaptured is returned to the dapp.

Apart from data feeds, API3 also provides [Quantum Random Number Generation](https://docs.api3.org/explore/qrng/) on Base Mainnet and Testnet. QRNG is a free-to-use service that provides quantum randomness onchain. It is powered by [Airnode](https://docs.api3.org/reference/airnode/latest/understand/), the first-party oracle that is directly operated by the [QRNG API providers](https://docs.api3.org/reference/qrng/providers.html). Read more about QRNG [here](https://docs.api3.org/reference/qrng).

Expand Down
2 changes: 1 addition & 1 deletion docs/cookbook/go-gasless.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -373,7 +373,7 @@ In this tutorial, you:
- Established **per-user** and **global** sponsorship **limits** to control costs.
- Demonstrated the **sponsorship flow** with Smart Accounts using `permissionless`, `viem`, and Foundry-generated private keys.

This approach can greatly improve your dApp’s user experience by removing gas friction. For more complex sponsorship schemes (like daily or weekly cycles), simply tweak your per-user and global limit settings in the Coinbase Developer Platform.
This approach can greatly improve your dapp’s user experience by removing gas friction. For more complex sponsorship schemes (like daily or weekly cycles), simply tweak your per-user and global limit settings in the Coinbase Developer Platform.

> **Next Steps**
>
Expand Down
6 changes: 3 additions & 3 deletions docs/get-started/base-services-hub.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@ Thank you to all the teams supporting the Base ecosystem and its builders! If yo
| [Fjord Foundry](https://www.fjordfoundry.com/) | Fundraising / Token Sale | Connecting innovative projects and community backers through on-chain capital formation, with over $1bn raised since 2021. | Free Premium Marketing | To claim this offer, simply tell us you discovered it through the Base Builder Services Hub when you contact Fjord. If your project passes our due‑diligence review and is selected as a launch partner, you’ll be eligible. |
| [FLock.io](https://www.flock.io/) | AI | FLock.io is the first decentralized AI training platform combining Federated Learning and blockchain to enable secure, privacy-preserving model training. | Base ecosystem projects get up to 50% off Qwen tokens using FLock.io-trained models or other major Qwen variants, plus: 1 free FLock.io training task and 1hr free AI consultation. | Please fill out this [Google Form](https://forms.gle/N8We623NQdAppEj26) with your application and contract information. <br/><br/> <br/><br/> FLock.io team will contact you once we receive your application. |
| [Flow](http://flowonbase.com) | FX, Ramping, Payments | Flow empowers projects with seamless FX, global payments, and local‐currency on/off-ramping — and offers its best pricing to those building or migrating onto Base. | For Base Builders, we offer 15% minimum discount on global ramping requirements & zero license fee for white label products. Further discounts available volume dependent. | Get market-leading FX, on/off-ramp, and global payment rates. We offer unmatched pricing that beats any verified competitor quote — book a consultation at flowonbase.com |
| [GetBlock](getblock.io) | Infrastructure provider | GetBlock is a Web3 infrastructure provider that offers a suite of APIs and tools to help developers build and scale decentralized applications (dApps) on top of 75+ blockchain protocols. | 50% off the first month on all shared node plans | To redeem this offer, reach out via https://getblock.io/contact with your UID and the promo code Welcome Treat, mentioning that you are building on Base. |
| [GetBlock](getblock.io) | Infrastructure provider | GetBlock is a Web3 infrastructure provider that offers a suite of APIs and tools to help developers build and scale decentralized applications (dapps) on top of 75+ blockchain protocols. | 50% off the first month on all shared node plans | To redeem this offer, reach out via https://getblock.io/contact with your UID and the promo code Welcome Treat, mentioning that you are building on Base. |
| [GrailPay](https://www.grailpay.com) | Authentication, Fraud, Account Validation | GrailPay authenticates bank accounts and stablecoin transactions for Base builders, enabling verified payment identities and safer fiat-to-onchain flows. | $1,500 in credits toward GrailPay’s authentication and verification APIs. | Submit your project details to support@grailpay.com. After verifying Base builder eligibility, we will provision $1,500 in authentication credits to your GrailPay account. |
| [Hexens](Hexens.io) | Security | At Hexens, we provide security audits to protect the future of Web3. We directly secure $120B+ in assets, working with industry leaders like Lido, EigenLayer, LayerZero, 1inch, Ava Labs, and Polygon. | Hexens will provide a discount of 15% for smart contract audits and 10% for services like pentest’s, and social engineering. Full triage will be provided for our bug bounty [r.xyz] for 3 months. | Please send your audit request to alice.rigby@hexens.io or @alicerigby on Telegram. |
| [Hypernative](https://www.hypernative.io/) | Security | Hypernative is the leading real-time security and threat prevention platform trusted by over 200 projects—including Ethena, Uniswap, Ethereum Foundation, Morpho, Chainlink, Solana, and Kraken. | Receive a discounted rate for the first year for Hypernative's real-time threat prevention platform. | Email marshall@hypernative.io to begin your trial and claim your offer. |
Expand Down Expand Up @@ -70,11 +70,11 @@ Thank you to all the teams supporting the Base ecosystem and its builders! If yo
| [Braille Studio](https://braille.wtf) | Product Design, Branding, Motion/Video, Web Design, Engineering | We design and build products for Based teams, covering brand, web, product, and launch assets, all focused on shipping something people can actually use. | 15% off our services and a free 1-hour mentoring session. (Starts at $3,000) | croissant@braille.wtf or Telegram: [braille_studio](https://t.me/braille_studio) |
| [Builders Garden](https://www.builders.garden/) | Product Studio | Fullstack product studio, specialized in consumer crypto use cases. | 15 mins free review / feedback sessions. | Telegram: @limone_eth |
| [Dacoit Design](https://www.dacoit.design/) | Design Studio | Full-stack crypto-native design studio specializing in brand identity, website design, and product design for Web3 projects. | Complimentary design audit. 20% discount on retainer engagements. (Starting at $7,500 for a 2-week branding sprint) | Telegram: @karanruparel or Email: karan@dacoit.design |
| [Ethereal Labs](https://www.ethereallabs.io/) | Full Stack Crypto Development Agency | End-to-end Web3 engineering with a focus on bespoke smart-contract architecture, high-performance dApp development, and secure on-chain infrastructure, taking projects from concept to production-ready launch. | 10% discount on services and free initial consultation. | dev@ethereallabs.io, Telegram: [ethereallabs](https://t.me/ethereallabs), or X: [@ethereallabs_](https://x.com/ethereallabs_) |
| [Ethereal Labs](https://www.ethereallabs.io/) | Full Stack Crypto Development Agency | End-to-end Web3 engineering with a focus on bespoke smart-contract architecture, high-performance dapp development, and secure on-chain infrastructure, taking projects from concept to production-ready launch. | 10% discount on services and free initial consultation. | dev@ethereallabs.io, Telegram: [ethereallabs](https://t.me/ethereallabs), or X: [@ethereallabs_](https://x.com/ethereallabs_) |
| [ForceField Digital](https://www.forcefield.digital/) | Marketing Agency | ForceField is the operating group and growth partner for Kenetic Capital and a leading venture capital in Web3 with over 300 investments. ForceField is a Web3-native growth partner that delivers real traction. | Base ecosystem members will receive a 20% discount. | info@forcefield.digital |
| [Gloww](https://gloww.design) | Product Design, UX/UI, Branding, and Motion Design | Gloww gives Base builders hands-on product design support, working like an embedded founding designer. Focus is on shaping the product, polishing the UX, refining the visuals, and shipping high quality interfaces. | Happy to give anyone coming from Base services Hub a 20% off. ($3,000 min fee) | DM @akshitvrma on Telegram |
| [GMGM Media](http://gmgm.media/) | Video Editing | Podcast repurposing, TikToks, interviews, launch / hype videos. | No payment required upfront. | Message @GMGMMedia on TG |
| [HeimLabs](https://www.heimlabs.com/) | Fullstack Blockchain Development + Design + DevRel Agency | Delivers end-to-end blockchain engineering — full-stack dApp and miniapp development paired with high-quality DevRel content creation. | Free consultation. 20% off on the first order. Unlimited revisions on design (within reason). Bonus content in the DevRel package. ($250 min fee) | email: info@heimlabs.com or Telegram: [xhohenheim](https://t.me/xhohenheim) |
| [HeimLabs](https://www.heimlabs.com/) | Fullstack Blockchain Development + Design + DevRel Agency | Delivers end-to-end blockchain engineering — full-stack dapp and miniapp development paired with high-quality DevRel content creation. | Free consultation. 20% off on the first order. Unlimited revisions on design (within reason). Bonus content in the DevRel package. ($250 min fee) | email: info@heimlabs.com or Telegram: [xhohenheim](https://t.me/xhohenheim) |
| [High Agency](https://highagencydevrel.com/) | Developer relations, developer experience, developer onboarding | We make your Web3 product easier to understand, integrate, and build with. From improving documentation and onboarding to growing engaged communities and creating technical content, we ensure developers can adopt your technology seamlessly. | Free initial consultation where we will identify gaps in developer onboarding experience and points of improvement. | Telegram: @enjojoy |
| [Ice Breaker TV](https://x.com/ice_breaker_tv) | Twitter Space Show Host | Twitter space / show / podcast / livestream hosting. | Open to discuss larger package deals for discounts / perks for multiple bookings. ($300 / hourly show min fee) | Telegram or Discord @ice_breaker_tv |
| [Jonathan Kramer](https://www.jonathankramer.net/) | Video | Concept development, writing, directing, producing, editing, and much more to help produce the videos of your dreams. | Free consultation. | KramersEmail@gmail.com |
Expand Down
2 changes: 1 addition & 1 deletion docs/iframe-theme.js
Original file line number Diff line number Diff line change
Expand Up @@ -53,7 +53,7 @@
document.addEventListener("DOMContentLoaded", updateIframesForDarkMode);
} else {
setTimeout(updateIframesForDarkMode, 100);
// TODO: add Storybook with Darkmode enabled
// Storybook darkmode implementation pending
let themeChangeCount = 0;
const themeChangeInterval = setInterval(() => {
if (themeChangeCount < 2) {
Expand Down
3 changes: 2 additions & 1 deletion docs/learn/arrays/filtering-an-array-sbs.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,8 @@ contract ArrayDemo {
uint[] public numbers = [1,2,3,4,5,6,7,8,9,10];
function getEvenNumbers() external view returns(uint[] memory) {
// TODO
// TODO: Filter and return only the even numbers from the numbers array
// Hint: You'll need to count them first to allocate memory
}
}
```
Expand Down
26 changes: 18 additions & 8 deletions docs/learn/deployment-to-testnet/test-networks.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -67,21 +67,31 @@ Several well-known testnets have emerged over the years, each with its own set o
![Comparison of Test Networks](/images/learn/deployment-to-testnet/testnet-comparison.png)
</Frame>

### L1 Testnets
### Active Testnets (Recommended)

- **Ropsten:** Ropsten played a significant role in Ethereum's history but was effectively deprecated by late 2022 when the Merge took place. The Merge marked the transition from proof-of-work to proof-of-stake consensus for the Ethereum mainnet. Ropsten's vulnerability to spam attacks and network instability made it unreliable for testing purposes.
#### Base Sepolia (L2)
Base Sepolia is the recommended testnet for all Base development. It settles on the Ethereum Sepolia L1 testnet and provides an environment for testing L2-specific features and smart contracts.

- **Rinkeby:** Rinkeby offered better security than Ropsten and used a proof-of-authority consensus mechanism. However, it lacked decentralization and client diversity, which ultimately led to its decline in popularity. After the Merge, Rinkeby is no longer a recommended test network.
#### Sepolia (L1)
Sepolia is the primary stable testnet for Ethereum development. It is designed for developers seeking a lighter weight chain for faster synchronization and interaction. It is the preferred testnet for L1 development.

- **Goerli:** Launched in early 2019, Goerli initially utilized a multi-client proof-of-authority consensus model to improve stability and security. Following the Merge, it transitioned to a proof-of-stake consensus mechanism, maintaining its cross-client compatibility and making it an ideal choice for developers. As of January 2024, Goerli is being sunset in favor of Sepolia.
#### Optimism Sepolia (L2)
Optimism Sepolia is built on the Ethereum Sepolia L1 testnet and offers a testing environment for Optimism's Layer-2 features.

- **Sepolia:** As one of the two original primary testnets alongside Goerli, Sepolia is designed for developers seeking a lighter weight chain for faster synchronization and interaction. As of January 2024, it is now the preferred testnet and developers should migrate to using it.
---

### Deprecated Testnets

The following networks are deprecated and should not be used for new development:

### L2 Testnets
#### Goerli (L1)
Launched in early 2019, Goerli was a popular multi-client testnet. As of January 2024, Goerli has been sunset in favor of Sepolia.

- **Base Sepolia:** As new Layer-2 networks emerged that settled on Ethereum's Layer-1, the need for testnets dedicated to these L2 networks also arose. For instance, the L2 network Base has its own testnet, known as Base Sepolia. This testnet settles on the Ethereum Sepolia L1 testnet, providing an environment for testing L2-specific features and smart contracts.
#### Ropsten (L1)
Ropsten was deprecated in late 2022 after the Merge. It is no longer supported.

- **Optimism Sepolia:** Optimism, an Ethereum Layer-2 scaling solution utilizing Optimistic Rollups, has its own testnet called Optimism Sepolia. This testnet is also built on the Ethereum Sepolia L1 testnet and offers a testing environment for developers to experiment with Optimism's Layer-2 features, smart contracts, and apps.
#### Rinkeby (L1)
Rinkeby was deprecated after the Merge and is no longer supported.

---

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -508,7 +508,8 @@ Simply grab the first wallet in the list (you'll want to do something more elega
const { wallets } = useWallets();

// Grab the first wallet on the list
// TODO: Implement the option to allow the user to choose another wallet
// Note: For this demo, we simply default to the first wallet. In a production app,
// you should add a UI to allow the user to select which wallet to use.
const wallet = wallets[0];
```

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -334,7 +334,7 @@ In this tutorial, you:
- Established **per-user** and **global** sponsorship **limits** to control costs.
- Demonstrated the **sponsorship flow** with Smart Accounts using `permissionless`, `viem`, and Foundry-generated private keys.

This approach can greatly improve your dApp’s user experience by removing gas friction. For more complex sponsorship schemes (like daily or weekly cycles), simply tweak your per-user and global limit settings in the Coinbase Developer Platform.
This approach can greatly improve your dapp’s user experience by removing gas friction. For more complex sponsorship schemes (like daily or weekly cycles), simply tweak your per-user and global limit settings in the Coinbase Developer Platform.

> **Next Steps**
>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@ This tutorial assumes that you're reasonably comfortable writing basic smart con

## Types of Providers

Onchain apps need frontends, sometimes called dApps, to enable your users to interact with your smart contracts. A _provider_ makes the connection from frontend to the blockchain, and is used to read data and send transactions.
Onchain apps need frontends, sometimes called dapps, to enable your users to interact with your smart contracts. A _provider_ makes the connection from frontend to the blockchain, and is used to read data and send transactions.

In blockchain development, the term _provider_ describes a company or service that provides an API enabling access to the blockchain as a service. This is distinct from the providers you wrap your app in using the [React Context API], though you'll use one of those to pass your blockchain provider deeply into your app.

Expand Down Expand Up @@ -226,7 +226,7 @@ const config = createConfig({
ssr: true,
transports: {
[base.id]: http('YOUR PROJECT URL'),
[mainnet.id]: http('TODO'),
// [mainnet.id]: http('https://mainnet.base.org'),
},
});
```
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -98,7 +98,7 @@ export function IssueList() {
return (
<div>
<h2>All Issues</h2>
<div>{/* TODO: List each issue */}</div>
<div>{/* TODO: Map over issues array and render IssueItem components for each issue */}</div>
</div>
);
}
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,7 @@ const {

useEffect(() => {
if (claimIsError) {
alert('Unable to claim'); // TODO: Better error handling
alert('Unable to claim: ' + (claimIsError ? 'Transaction simulation failed' : ''));
}
}, [claimIsError]);

Expand Down
3 changes: 2 additions & 1 deletion docs/learn/token-development/erc-721-token/erc-721-sbs.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -186,7 +186,8 @@ function _baseURI() internal override view returns(string memory) {
}
function switchURI() public {
// TODO: Limit to contract owner
// Requirements: use OpenZeppelin Ownable.sol and add onlyOwner modifier
// function switchURI() public onlyOwner {
nftMetadata = nftMetadata == NFTMetadata.BAYC ? NFTMetadata.DOODLES : NFTMetadata.BAYC;
}
```
Expand Down
Loading