From 83ce90f8f5f05a16e611aba44e6a4f2118aae372 Mon Sep 17 00:00:00 2001 From: Erhnysr Date: Mon, 6 Apr 2026 22:47:00 +0300 Subject: [PATCH 1/3] docs: add RPC usage clarification note Adds a clarification note about using the correct RPC endpoint when building on Base. --- README.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/README.md b/README.md index d3d19bbbb..52dd475ce 100644 --- a/README.md +++ b/README.md @@ -164,3 +164,6 @@ The core team will review opened PRs. The SLA is 2 weeks, generally on a first-c ## Storybook for UI components See `storybook/README.md` for details on local Storybook and component docs. +## Additional Note + +When building on Base, always ensure that you are using the correct RPC endpoint for the intended network (mainnet or testnet). Misconfiguration can lead to failed transactions or unexpected behavior. From d562b420d2975cb6433cb40cc28bb68033381bf0 Mon Sep 17 00:00:00 2001 From: erhan yasar Date: Sat, 18 Apr 2026 16:02:12 +0300 Subject: [PATCH 2/3] docs: add spend permissions cookbook guide --- docs/cookbook/implement-spend-permissions.mdx | 30 +++++++++++++++++++ 1 file changed, 30 insertions(+) create mode 100644 docs/cookbook/implement-spend-permissions.mdx diff --git a/docs/cookbook/implement-spend-permissions.mdx b/docs/cookbook/implement-spend-permissions.mdx new file mode 100644 index 000000000..8b6b93b3e --- /dev/null +++ b/docs/cookbook/implement-spend-permissions.mdx @@ -0,0 +1,30 @@ +--- +title: "Implement Spend Permissions" +description: "Learn how to allow apps to spend tokens on behalf of users without repeated approval prompts using Base Account." +--- + +# Implement Spend Permissions + +Spend Permissions allow smart wallets to grant specific allowances to a spender (your app's backend) for a set period. This enables seamless experiences like subscriptions, automatic trading, or gasless payments. + +## How it works + +1. **Request Permission:** The user signs a typed data structure defining the `allowance`, `period`, and `spender`. +2. **Onchain Approval:** The signature is submitted to the `SpendPermissionManager` contract. +3. **Execution:** The authorized spender calls `spend()` to transfer assets within the allowed limit. + +## Implementation Steps + +### 1. Build the Permission +```typescript +const permission = { + account: userAddress, + spender: "0xYourBackendAddress", + token: "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE", // Native ETH + allowance: parseEther("0.1"), + period: 2592000, // 30 days + start: Math.floor(Date.now() / 1000), + end: Math.floor(Date.now() / 1000) + (2592000 * 12), // 1 year + salt: BigInt(0), + extraData: "0x", +}; \ No newline at end of file From bc9d1d6f6c18864a376727ec1fdf5c5ea4df3197 Mon Sep 17 00:00:00 2001 From: erhan yasar Date: Sat, 18 Apr 2026 16:04:33 +0300 Subject: [PATCH 3/3] docs: add MiniKit to Base Apps migration guide --- .../quickstart/migrate-minikit-to-apps.mdx | 23 +++++++++++++++++++ 1 file changed, 23 insertions(+) create mode 100644 docs/apps/quickstart/migrate-minikit-to-apps.mdx diff --git a/docs/apps/quickstart/migrate-minikit-to-apps.mdx b/docs/apps/quickstart/migrate-minikit-to-apps.mdx new file mode 100644 index 000000000..b88a76005 --- /dev/null +++ b/docs/apps/quickstart/migrate-minikit-to-apps.mdx @@ -0,0 +1,23 @@ +--- +title: "Migrate from MiniKit to Base Apps SDK" +description: "A checklist and guide for migrating your existing apps to the new Base Apps SDK." +--- + +# Migrating to Base Apps SDK + +Base has evolved the "Mini Apps" ecosystem into the broader **Base Apps**. This transition involves a few breaking changes in the SDK and documentation structure. + +## Quick Checklist +- [ ] Rename `useMiniKit` to `useBaseApp`. +- [ ] Update imports from `@coinbase/minikit` to the latest version. +- [ ] Review Farcaster manifest requirements (now optional for standard web apps). + +## Code Changes + +### Hook Update +```typescript +// Old +import { useMiniKit } from "@coinbase/minikit"; + +// New +import { useBaseApp } from "@coinbase/minikit"; \ No newline at end of file