converting-minikit-to-farcaster

Original：🇺🇸 English

Not Translated

2 scripts

Converts Mini Apps from MiniKit (OnchainKit) to native Farcaster SDK. Use when migrating from @coinbase/onchainkit/minikit, converting MiniKit hooks, removing MiniKitProvider, or when user mentions MiniKit, OnchainKit, or Farcaster SDK migration.

2installs

Sourcebase/base-skills

Added on2026-02-25

NPX Install

npx skill4agent add base/base-skills converting-minikit-to-farcaster

SKILL.md Content

MiniKit to Farcaster SDK

Breaking Changes (SDK v0.2.0+)

```
sdk.context
```
is a Promise — must await
```
sdk.isInMiniApp()
```
accepts no parameters
```
sdk.actions.setPrimaryButton()
```
has no onClick callback

Check version:

npm list @farcaster/miniapp-sdk

Quick Reference

MiniKit	Farcaster SDK	Notes
`useMiniKit().setFrameReady()`	`await sdk.actions.ready()`
`useMiniKit().context`	`await sdk.context`	Async
`useMiniKit().isSDKLoaded`	`await sdk.isInMiniApp()`	No params
`useClose()`	`await sdk.actions.close()`
`useOpenUrl(url)`	`await sdk.actions.openUrl(url)`
`useViewProfile(fid)`	`await sdk.actions.viewProfile({ fid })`
`useViewCast(hash)`	`await sdk.actions.viewCast({ hash })`
`useComposeCast()`	`await sdk.actions.composeCast({ text, embeds })`
`useAddFrame()`	`await sdk.actions.addMiniApp()`
`usePrimaryButton(opts, cb)`	`await sdk.actions.setPrimaryButton(opts)`	No callback
`useAuthenticate()`	`sdk.quickAuth.getToken()`	See AUTH.md

Context Access Pattern

typescript

// WRONG
const fid = sdk.context?.user?.fid;

// CORRECT
const context = await sdk.context;
const fid = context?.user?.fid;

In React components, use state:

typescript

const [context, setContext] = useState(null);

useEffect(() => {
  const load = async () => {
    const ctx = await sdk.context;
    setContext(ctx);
  };
  load();
}, []);

Conversion Workflow

Verify Node.js >= 22.11.0
Update dependencies — see DEPENDENCIES.md

Replace imports:

@coinbase/onchainkit/minikit

→

@farcaster/miniapp-sdk

Convert hooks using reference above
Add FrameProvider — see PROVIDER.md
Update manifest:
```
frame
```
→
```
miniapp
```
— see MANIFEST.md

Common Errors

"Property 'user' does not exist on type 'Promise<MiniAppContext>'" → Await

sdk.context

before accessing properties

"Expected 0 arguments, but got 1" → Remove parameters from

sdk.isInMiniApp()

Context is null in components → Ensure FrameProvider is in your provider chain

References

MAPPING.md — Complete hook-by-hook conversion reference
EXAMPLES.md — Before/after code examples
PROVIDER.md — Provider setup with FrameProvider
PITFALLS.md — Common errors and solutions
DEPENDENCIES.md — Package updates
AUTH.md — Quick Auth migration
MANIFEST.md — farcaster.json changes