Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
23 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
9d353f7
fix: replace legacy spelling on-chain with onchain in bridge-tokens-w…
Earnwithalee7890 Jan 25, 2026
ff5d6ba
fix: repair https link upgrade
Earnwithalee7890 Jan 26, 2026
2b68762
fix: update aboutads.info link to https
Earnwithalee7890 Jan 27, 2026
aa65ce1
fix: update networkadvertising.org link to https
Earnwithalee7890 Jan 27, 2026
f8ce94a
fix: update x.com link to https
Earnwithalee7890 Jan 27, 2026
6e2afb3
fix: update privacy policy link to https
Earnwithalee7890 Jan 27, 2026
72f8049
fix: update telegram link to https
Earnwithalee7890 Jan 27, 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
4 changes: 2 additions & 2 deletions docs/cookie-policy.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -76,9 +76,9 @@ please note, if you set your browser to disable cookies, you may not be able to
of our Services. Also, if you disable cookies, other parts of our Services may not function properly.

There are also additional tools available to manage third party cookies. You can visit the DAA's
opt-out portal available at [optout.aboutads.info](http://optout.aboutads.info/), the DAA of Canada's
opt-out portal available at [optout.aboutads.info](https://optout.aboutads.info/), the DAA of Canada's
opt-out portal available at [youradchoices.ca/en/tools](https://youradchoices.ca/en/tools), or visit
the NAI's opt-out portal available at [optout.networkadvertising.org](http://optout.networkadvertising.org/?c=1).
the NAI's opt-out portal available at [optout.networkadvertising.org](https://optout.networkadvertising.org/?c=1).
Residents of the European Union may opt-out of online behavioural advertising served by the European
Interactive Digital Advertising Alliance's participating member organizations by visiting
[youronlinechoices.eu](https://www.youronlinechoices.eu/) or through your mobile device settings,
Expand Down
2 changes: 1 addition & 1 deletion docs/get-started/base-mentorship-program.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ Base Mentors are experienced founders, operators, and subject matter experts acr
| Anthony Bassili | [Coinbase Asset Management](https://x.com/SmartestBeta) |
| Antonio García Martínez | [Spindl (acq. Coinbase)](https://x.com/antoniogm) |
| Conor Grogan | [Coinbase](https://x.com/jconorgrogan) |
| Conner Swenberg | [Station Labs (acq. Coinbase)](http://x.com/ilikesymmetry) |
| Conner Swenberg | [Station Labs (acq. Coinbase)](https://x.com/ilikesymmetry) |
| Dariush Aghai | [Study Hall Creative](https://studyhall.design/about) |
| David Espinel | [Social Graph Ventures](https://www.socialgraph.vc/team) |
| Elena Nadolinski | [Iron Fish (acq. Coinbase)](https://x.com/leanthebean) |
Expand Down
4 changes: 2 additions & 2 deletions docs/get-started/base-services-hub.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ Thank you to all the teams supporting the Base ecosystem and its builders! If yo
| [Acctual](https://www.acctual.com/) | Invoicing | The easiest way to pay or send an invoice (AP/AR) in crypto and fiat. | 3 months of fee free invoicing on Base. | Acctual users who invoice on Base will receive fee free invoicing for the first 3 months, on all Base invoices. <br/><br/> <br/><br/> Users will need to reach out to support@acctual.com to redeem this offer. |
| [Almanax](https://www.almanax.ai/) | AI & Security | Almanax is an AI Security Engineer that uses LLMs to find security vulnerabilities every time companies push new code. | Base builders can get their first three months of Almanax premium plan for free. | Sign up for Almanax's product at https://app.almanax.ai/ <br/><br/> <br/><br/> Fill out this form and enter this promo code in the message field: "BASE-ALMANAX-DEAL" <br/><br/> <br/><br/> Once approved, you'll receive a confirmation emails. |
| [Anchor Zero](anchorzero.com) | Tax Planning | AnchorZero Roth IRAs can eliminate capital gains tax on pre-launch token investments | Waive all implementation fees | Mention you are building on Base in your introductory call with AnchorZero. |
| [Api3](https://www.api3.org/) | Oracle's / Data Infrastructure | API3 is an oracle service that delivers Real World Price Feeds to your smart contract. The Price feeds provided allow dapps to regain lost value with Oracle Extractable Value built in to the feed. | If you are a lending dapp deploying on BASE, stable coin, morpho curator, borrow/lending dapp we will provide oracle services to your markets. | Contact: http://t.me/billyjitsu <br/><br/> Or Request: https://api3dao.typeform.com/to/TBTu8bJt <br/><br/> The team will reach out and discuss the options for gas grants for oracle services. |
| [Api3](https://www.api3.org/) | Oracle's / Data Infrastructure | API3 is an oracle service that delivers Real World Price Feeds to your smart contract. The Price feeds provided allow dapps to regain lost value with Oracle Extractable Value built in to the feed. | If you are a lending dapp deploying on BASE, stable coin, morpho curator, borrow/lending dapp we will provide oracle services to your markets. | Contact: https://t.me/billyjitsu <br/><br/> Or Request: https://api3dao.typeform.com/to/TBTu8bJt <br/><br/> The team will reach out and discuss the options for gas grants for oracle services. |
| [Artemis](artemis.xyz) | Onchain Analytics | Artemis standardizes digital finance data into a single open data platform. Metrics that matter for digital finance. All in one place. | Artemis is offering free, out-of-the-box onchain metrics dashboards for Base builder's applications. | Please fill out the [Google Form](https://forms.gle/ZDS9LkxSBJVJonR36) with your application metadata and contract information. We will contact your email once your application dashboard has been created. |
| [Birdeye ](https://bds.birdeye.so/) | Data Analytics - Data API - Developer Tools | Birdeye Data Services is a high-performance data provider that delivers real-time, accurate, and comprehensive on-chain data across tokens, wallets, trades, and protocols. | - Startup/Projects get 30% OFF for first 6 months - Free access to our full Business Lite package (valued at $299) for teams participating in Hackathons or Base Batches during the program period. | Apply [here](https://docs.google.com/forms/d/e/1FAIpQLSfkv8JWR1WWq7Biqx5yyDvF6belUtdbR37mddludfu-boI34Q/viewform) <br/><br/> We will be in touch once the application has been reviewed. For any other inquiries, please reach out to BDS on Telegram: @birdeye_data. |
| [Cantina](https://cantina.xyz/welcome) | Security | Cantina is the one-stop shop for the highest quality security researchers and solutions. Reduce the likelihood of hacks, time spent, and context lost. | 10% off all services including audits, audit competitions, pen-testing, architecture reviews, fuzzing/unit/e2e testing 50% off of bug bounty hosting for the first year | https://cantina.xyz/introduction/base-cantina |
Expand Down Expand Up @@ -89,4 +89,4 @@ Thank you to all the teams supporting the Base ecosystem and its builders! If yo
| [Sealaunch Intelligence](http://sealaunch.xyz/) | Onchain Intelligence Advisory, Data Analytics, Custom Dune Dashboards | Onchain intelligence and strategic advisory for crypto companies. We conduct private research to drive growth and revenue decisions and create custom Dune Dashboards. | 15% discount with a minimum three-month engagement. | Fill out this [typeform](https://3spxelklbj0.typeform.com/to/NpNyMq98?utm_source=base) |
| [Spotlight Crypto](https://www.spotlightcrypto.xyz/) | Full Stack App Development | We build full stack apps on the frontier of crypto social, from ideation to design to smart contracts to GTM. | 15 mins free review / feedback sessions. | hello@spotlightcrypto.xyz |
| [Tarun Thusu](https://tarunthusu.com/portfolio.pdf) | Product and Brand design | I’m a product and brand designer with over 6 years of experience, helping businesses turn ideas into beautiful and functional digital products. From brand identity to user-focused product design, I build visuals, systems, and experiences that make products feel premium, intuitive, and memorable. | 20% discount and fast delivery of work. | Telegram: @tarunth |
| [Vacuumlabs](http://www.vacuumlabs.com/) | Software house / Development + design studio | Dev studio with 13 years in Fintech and 7 years in Crypto, we can help augment teams with experienced devs who are top talent from Central Europe; or we can design build and test entire apps in end2end delivery. Our services range from building a neobank MOX for Standard Chartered, to building decentralized onchain apps. | 10% discount for Base ecosystem clients. (Rates 400-1000 EUR/MD based on seniority) | peter.hucik@vacuumlabs.com, TG: @hukusik, or TG: @PenguDamien |
| [Vacuumlabs](https://www.vacuumlabs.com/) | Software house / Development + design studio | Dev studio with 13 years in Fintech and 7 years in Crypto, we can help augment teams with experienced devs who are top talent from Central Europe; or we can design build and test entire apps in end2end delivery. Our services range from building a neobank MOX for Standard Chartered, to building decentralized onchain apps. | 10% discount for Base ecosystem clients. (Rates 400-1000 EUR/MD based on seniority) | peter.hucik@vacuumlabs.com, TG: @hukusik, or TG: @PenguDamien |
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 @@ -48,7 +48,7 @@ The ETH is required for covering gas fees associated with deploying smart contra

LayerZero is an interoperability protocol that allows developers to build applications (and tokens) that can connect to multiple blockchains. LayerZero defines these types of applications as "omnichain" applications.

The LayerZero protocol is made up of immutable on-chain [Endpoints](https://docs.layerzero.network/v2/concepts/protocol/layerzero-endpoint), a configurable [Security Stack](https://docs.layerzero.network/explore/decentralized-verifier-networks), and a permissionless set of [Executors](https://docs.layerzero.network/v2/concepts/permissionless-execution/executors) that transfer messages between chains.
The LayerZero protocol is made up of immutable onchain [Endpoints](https://docs.layerzero.network/v2/concepts/protocol/layerzero-endpoint), a configurable [Security Stack](https://docs.layerzero.network/explore/decentralized-verifier-networks), and a permissionless set of [Executors](https://docs.layerzero.network/v2/concepts/permissionless-execution/executors) that transfer messages between chains.

### High-level concepts

Expand Down
Original file line number Diff line number Diff line change
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
Original file line number Diff line number Diff line change
Expand Up @@ -315,11 +315,11 @@ function render(uint _tokenId) public view returns (string memory) {
return string(
abi.encodePacked(
"<SVG xmlns='http://www.w3.org/2000/SVG' viewBox='0 0 1024 1024'>",
// TODO: Add the clouds,
// TODO: Add the sun,
// TODO: Add the land,
// TODO: Add the clouds SVG string
// TODO: Add the sun SVG string
// TODO: Add the land SVG string
seaRenderer.render(),
// TODO: Add the background,
// TODO: Add the background SVG string
"</SVG>"
)
);
Expand Down
7 changes: 6 additions & 1 deletion docs/learn/token-development/nft-guides/signature-mint.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -274,7 +274,12 @@ describe('Test', function () {
const ownerAddress = await owner.account.address;
const signer1Address = await signer1.account.address;

// TODO...
// create a signed message
const message = keccak256(encodePacked(['address'], [signer1Address]));
const messageBytes = toBytes(message);
const signature = await owner.signMessage({
message: { raw: messageBytes },
});

// Signer 1 calls the mintTo function with the signature
expect(await soulboundSignatureMint.write.mintTo([signer1Address, signature])).to.be.ok;
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -89,7 +89,9 @@ function tokenURI(uint _tokenId) public view override returns (string memory) {
' #: ',
Strings.toString(_tokenId),
'","description": "Random colors are pretty or boring!", "image": "data:image/svg+xml;base64,',
// TODO...,
// Create the SVG string with the random color
// <rect width='1024' height='1024' fill='...color...' />
Base64.encode(bytes(render(_tokenId))),
'"}'
)
)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -391,9 +391,11 @@ export const getNFTColors = async (req: Request, res: Response) => {

const response = await axiosInstance.get(url, { headers: headers });

// TODO: Extract the color from the image
// TODO: Extract the color from the image using helper function
// const color = getColorFromSVG(image);

// TODO: Replace response
// TODO: Replace response with just the color data
// res.json({ color });
res.json(response.data);
} catch (error) {
console.error(error);
Expand Down
16 changes: 15 additions & 1 deletion docs/mini-apps/quality-and-publishing/overview.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,20 @@ title: Overview
description: How to meet the bar and submit your Mini App for featuring
---

TODO: Write end‑to‑end guidance for becoming Featured: prerequisites, examples, review process, and timelines. Link to Quality Bar and Submission Guidelines.
## The Path to Featuring

Getting your Mini App featured on the Base ecosystem page is a great way to drive growth and visibility. The process is designed to ensure high-quality, secure, and usable experiences for all users.

### Process at a Glance

1. **Build**: Develop your Mini App following our [Design Guidelines](/mini-apps/featured-guidelines/design-guidelines) and [Technical Guidelines](/mini-apps/featured-guidelines/technical-guidelines).
2. **Self-Review**: Test your app against the [Quality Bar](/mini-apps/quality-and-publishing/quality-bar) to ensure it meets performance and UX standards.
3. **Submit**: Prepare your assets and submit via the [Submission Form](https://docs.base.org/form-link-placeholder).
4. **Review**: The Base team reviews submissions on a rolling basis.
5. **Launch**: If approved, your app will be featured in the "Explore" section.

### Timelines

Review times vary but typically take **1-2 weeks**. You will be notified via email about the status of your submission.


18 changes: 17 additions & 1 deletion docs/mini-apps/quality-and-publishing/quality-bar.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,22 @@ title: Quality Bar
description: The standards your Mini App should meet before being featured
---

TODO: Draft the full Quality Bar article with performance, stability, UX, and instrumentation requirements. Link concrete acceptance criteria and example checks.
Apps featured in the Base ecosystem must meet high standards for performance, security, and user experience.

## Performance & Stability
* **Load Time**: Must load interactive content within 3 seconds on LTE/4G.
* **Responsiveness**: No jank or frame drops during scroll or animations.
* **Stability**: Crash-free sessions > 99%.

## UX & Design
* **Mobile First**: Layout must be optimized for mobile screens (responsive).
* **Navigation**: Users must be able to navigate back and close the app easily.
* **No Dead Ends**: Every screen must have a clear path forward or backward.
* **Visuals**: Use high-quality assets; no pixelated icons or unreadable text.

## Security
* **Permissions**: Only request permissions (e.g., wallet address, location) when necessary.
* **Data Handling**: User data must be encrypted in transit and at rest.
* **Scams/Spam**: Apps promoting scams, rug pulls, or excessive spam will be banned immediately.


Loading