
Solana Frames: Mencetak cNFT di Farcaster
Apa yang Dibahas dalam Artikel Ini?
Media sosial terdesentralisasi menandai pergeseran besar menuju pemberdayaan pengguna dengan privasi dan kendali yang lebih besar atas data online mereka. Tidak seperti platform media sosial tradisional, jaringan terdesentralisasi memungkinkan individu mengelola grafik sosial dan identitas digital mereka secara langsung. Platform seperti Farcaster berada di garis depan dengan menciptakan jaringan tahan sensor yang mendukung komunikasi terbuka dan interoperabel di berbagai platform. Salah satu inovasi utama Farcaster adalah frames, yang mengubah postingan media sosial biasa menjadi aplikasi lengkap untuk memperkaya pengalaman sosial online.
Artikel ini akan membahas Farcaster dan dukungan Solana terbarunya. Kami akan menjelaskan apa itu Farcaster, apa itu frames, dan cara memverifikasi alamat Solana. Kemudian, kami akan menyajikan tutorial singkat untuk membuat frame yang mencetak cNFT ke alamat Solana terverifikasi milik pengguna menggunakan Helius Mint API. Tutorial ini mengasumsikan Anda sudah memiliki pengalaman dengan TypeScript dan Next.js.
Apa Itu Farcaster?
Farcaster adalah jaringan sosial yang cukup terdesentralisasi dan memanfaatkan jaringan Ethereum. Platform ini menyediakan ruang publik yang mirip dengan jaringan sosial populer seperti Twitter dan Reddit. Pengguna dapat membuat profil, membagikan postingan (disebut casts), dan mengikuti pengguna lain. Hal yang membedakan Farcaster adalah penekanannya pada kepemilikan dan portabilitas pengguna—pengguna memiliki akun dan relasi mereka dengan orang lain. Mereka dapat berpindah antar aplikasi sambil mempertahankan identitas digital dan grafik sosialnya.
Apa Itu Frames?
Frames memungkinkan developer mengubah cast apa pun menjadi aplikasi interaktif. Dengan memperluas standar OpenGraph, Frames mengubah sematan statis menjadi pengalaman yang dinamis dan interaktif. Dengan demikian, pengguna dapat membuat fitur seperti jajak pendapat, feed langsung, atau galeri interaktif di dalam klien Farcaster apa pun, termasuk Warpcaster. Pada dasarnya, frame adalah sekumpulan tag <meta> yang dikembalikan bersama <head> dari halaman HTML. Aplikasi Farcaster akan merender halaman sebagai frame jika halaman tersebut memuat semua properti frame yang diperlukan. Spesifikasi Frame menguraikan properti yang diperlukan tersebut. Sebagai contoh, frame awal harus:
- Mengembalikan frame yang valid di bagian HTML
<head> - Mengembalikan HTML
<body>yang valid jika pengguna membuka frame tersebut melalui browser - Tidak menyertakan konten dinamis dalam frame awal karena klien Farcaster menyimpannya dalam cache
- Tidak menyertakan tag
fc:frame:state
Memverifikasi Alamat Solana di Farcaster
Farcaster baru-baru ini menambahkan dukungan untuk alamat Solana. Artinya, developer dapat membuat frame yang berinteraksi dengan dompet Solana pengguna. Dalam waktu kurang dari 24 jam sejak dukungan ini diluncurkan, lebih dari 9328 FID Farcaster unik telah memverifikasi alamat Solana.
Pengguna dapat memverifikasi alamat Solana mereka dengan:
- Membuka Pengaturan
- Mengeklik Alamat Terverifikasi, lalu mengeklik tombol “Verifikasi alamat”
- Menghubungkan dompet Solana mereka dan menandatangani pesan untuk membuktikan kepemilikan
Perhatikan bahwa satu-satunya dompet yang saat ini didukung adalah Phantom.
Tutorial: Membuat Frame yang Mencetak cNFT
Dalam artikel ini, kita akan membuat Frame yang memungkinkan pengguna dengan alamat Solana terverifikasi mencetak NFT terkompresi (cNFT). Kita akan menyiapkan proyek menggunakan frames.js, yaitu template Next.js untuk membuat dan men-debug frame. Kita akan menggunakan OnchainKit dari Coinbase, khususnya Frame Kit, untuk mengambil informasi pengguna Farcaster saat mereka berinteraksi dengan frame. Kemudian, kita akan memasukkan data ini ke Helius Mint API untuk mencetak cNFT berikut ke dompet Solana pengguna:
Menyiapkan Frame Kita
Membuat frame dengan frame.js semudah mengkloning template awal. Cukup jalankan perintah berikut dan ganti <name> dengan nama folder baru tempat Anda ingin mengkloning template:
npx degit github:framesjs/frames.js/examples/framesjs-starter#main <name>Saya memutuskan untuk menamai direktori saya helius-frame, jadi saya mengganti <name> dengan <helius-frame>. Selanjutnya, masuk ke direktori baru (misalnya, cd helius-frame) dan instal dependensi yang diperlukan melalui perintah yarn install. Setelah pengunduhan selesai, jalankan yarn dev untuk menjalankan server pengembangan. Buka http://localhost:3000 di browser Anda untuk melihat tampilan berikut:
Dengan mengeklik hyperlink Debug, kita akan diarahkan ke http://localhost:3000/debug:
Ini berguna karena kita dapat menguji frame secara lokal tanpa men-deploy-nya. Misalnya, kita dapat masuk untuk menguji tombol, menyamar sebagai pengguna lain, dan membuat tiruan status hub. Warpcaster juga memiliki alat Frame Validator yang sangat baik untuk memvalidasi frame. Selanjutnya, kita akan menggunakan alat Frame Validator untuk pengujian, semata-mata karena preferensi pribadi.
Selanjutnya, jalankan yarn install untuk menginstal dependensi template yang relevan. Kita juga perlu menjalankan yarn install @coinbase/onchainkit untuk menginstal OnchainKit.
Kita akan menata ulang folder proyek sebagai berikut:
- Hapus folder examples—meskipun contoh-contoh tersebut memberikan wawasan berharga tentang pembuatan frame, kita tidak memerlukannya untuk tujuan ini. Menghapus folder tersebut akan mengurangi ukuran proyek. Namun, saya sangat menyarankan Anda memeriksanya untuk melihat cara alternatif membuat frame yang umum
- Buat folder api di direktori app. Langkah ini mengikuti konvensi Next.js untuk rute API dengan memberikan pemisahan yang jelas antara frontend dan backend aplikasi kita. Kemudian, pindahkan folder frames (beserta isinya, yaitu route.ts) ke folder api yang baru.
- Buat folder utils di direktori app. Di folder baru ini, buat file mint.ts—di sinilah kita akan menempatkan logika pencetakan cNFT
Sekarang kita akhirnya dapat mulai membuat frame!
Mengedit Frame Kita
layout.tsx
Kita akan mulai dengan file layout.tsx. Hapus seluruh isinya dan ganti dengan kode berikut:
export default function RootLayout({
children,
}: {
children: React.ReactNode;
}) {
return (
{children}
);
}Komponen RootLayout menggunakan pendekatan minimalis untuk membungkus seluruh aplikasi dengan struktur tata letak yang konsisten. Komponen ini fleksibel dan dirancang agar dapat digunakan kembali. Dengan memulai dari tata letak minimalis ini, developer dapat menggunakan file tersebut sebagai template untuk membuat dan menyesuaikan frame sendiri sesuai kebutuhan.
Perhatikan bahwa mengubah file layout.tsx akan menyebabkan masalah saat menggunakan debugger secara lokal. Mengedit layout.tsx tidak wajib. Namun, kita melakukannya untuk memperkenalkan metadata aplikasi dalam page.tsx. Sebagai solusi alternatif, Anda dapat menambahkan metadata tersebut dalam file ini.
page.tsx
Hapus isi page.tsx dan ganti dengan kode berikut:
import type { Metadata } from "next";
import { getFrameMetadata } from "@coinbase/onchainkit";
const baseURL = "https://helius-frame.vercel.app/";
const frameMetadata = getFrameMetadata({
image: {
src: `${baseURL}/default.jpg`,
aspectRatio: "1:1",
},
buttons: [
{
label: "Click to mint a cNFT on Solana!",
action: "post",
},
],
postUrl: `${baseURL}api/frames`,
});
export const metadata: Metadata = {
title: "Mint a cNFT on Solana",
description: "Mint a cNFT to your verified Solana address using the Helius Mint API",
openGraph: {
title: "Mint a cNFT on Solana",
description: "Mint a cNFT to your verified Solana address using the Helius Mint API",
images: ["https://helius-frame.vercel.app/default.jpg"],
},
other: {
...frameMetadata,
},
};
export default function Page() {
return (
Mint a cNFT on Farcaster using the Helius Mint API
Built by 0xIchigo
GitHub Repo
);
}Kode di atas menyiapkan frame awal kita, yang akan tersedia di sebuah URL pada server web. Dalam kasus saya, frame awal di-hosting di Vercel pada https://helius-frame.vercel.app/—nanti dalam tutorial ini, kita akan membahas cara men-deploy dengan Vercel.
Pertama, kita mengimpor tipe Metadata dari Next.js untuk menentukan tipe ekspor metadata dalam file ini. Kita juga mengimpor getFrameMetadata dari @coinbase/onchainkit. Kemudian, kita menetapkan URL dasar aplikasi untuk mengurangi pengulangan kode.
Kemudian, kita memanggil getFrameMetadata untuk mengonfigurasi metadata frame awal. Metadata ini mencakup:
- Gambar (yaitu src) yang berfungsi sebagai elemen visual frame dengan rasio aspek 1:1
- Tombol berlabel “Klik untuk mencetak cNFT di Solana!” yang, saat diklik, memicu permintaan POST ke
postUrlyang ditentukan (yaitu${baseURL}api/frames). Tindakan ini memulai proses pencetakan
Kemudian, kita mengekspor objek metadata yang memuat judul dan deskripsi halaman, metadata OpenGraph (yaitu openGraph), serta frameMetadata yang sebelumnya ditentukan dan disebarkan ke properti other.
Terakhir, page menetapkan dan mengekspor komponen halaman default. Kita mengembalikan h1 sederhana yang meminta pengguna mencetak cNFT. Ini karena Farcaster mengharuskan kita mengembalikan HTML—interaksi utama dikelola melalui frame, bukan dengan mengakses situs secara langsung. Namun, jika pengguna mengeklik untuk membukanya, situs tetap harus memiliki konten.
mint.ts
Tempel kode berikut ke mint.ts:
const url = `Get a URL at dev.helius.xyz`;
export const mintCompressedNFT = async (address: string) => {
const response = await fetch(url, {
method: "POST",
headers: {
"Content-Type": "application/json",
},
body: JSON.stringify({
jsonrpc: "2.0",
id: "frames-sol-mint",
method: "mintCompressedNft",
params: {
name: "Solana Soldier",
symbol: "HELIUS",
owner: address,
description: "A decentralized warrior backed by Solana's most loved RPC Nodes, APIs, Webhooks, and Developer Tooling",
attributes: [
{
trait_type: "RPCs",
value: "Fast",
},
{
trait_type: "Company",
value: "Helius"
},
],
imageUrl: "https://shdw-drive.genesysgo.net/HmvVwYAy7cxWECLbu2cjWBSHysVoriTqgdugyePVg3rY/cnftmint.jpg",
externalUrl: "https://www.helius.dev/",
sellerFeeBasisPoints: 6900,
},
}),
});
const data = await response.json();
console.log(`data: ${JSON.stringify(data, null, 2)}`);
if (!response.ok) {
throw new Error(`The response was not okay - ${response.status}`);
}
if (!data.result || !data.result.assetId) {
throw new Error(`The response did not include the expected data.result.assetId field`);
}
return data.result;
};Fungsi utilitas mintCompressedNFT sangat penting bagi aplikasi karena fungsi ini mencetak cNFT yang telah ditentukan sebelumnya ke alamat tertentu. Kita menggunakan Helius Mint API untuk membuat fungsi asinkron yang sederhana dan dapat digunakan kembali guna mengenkapsulasi proses pencetakan cNFT. Kita harus meminta Helius General RPC URL, yang ditetapkan sebagai url. Jika belum memilikinya, buka dasbor Helius Anda untuk membuat RPC URL gratis yang dapat digunakan untuk url.
Perhatikan bahwa repositori saya menggunakan SecureRPC URL saya—berhati-hatilah agar tidak membocorkan kunci API Anda dan pertimbangkan untuk menjalankan proxy. Untuk permintaannya sendiri, penjelasan lengkap mengenai skema permintaan dapat ditemukan di sini.
Perhatikan juga bahwa saya sudah mengunggah gambar cNFT ke ShdwDrive karena, saat artikel ini ditulis, Farcaster belum menambahkan dukungan transaksi penuh—Helius Mint API menangani pengunggahan metadata off-chain ke Arweave selama signer disediakan.
Fungsi ini juga menyertakan penanganan error yang andal untuk memastikan setiap masalah selama proses pencetakan ditangkap dan dilaporkan. Fungsi ini juga mencatat data respons untuk keperluan debugging.
route.ts
Di api/frames/route.ts, tempel kode berikut:
import { NextRequest, NextResponse} from "next/server";
import { getFrameMessage, getFrameHtmlResponse } from "@coinbase/onchainkit/frame";
import { mintCompressedNFT } from "../../utils/mint";
const baseURL = "https://helius-frame.vercel.app/";
export async function POST(req: NextRequest): Promise {
const body = await req.json();
// Validate the frame message and extract the user ID
const { isValid, message } = await getFrameMessage(body, {
neynarApiKey: "NEYNAR_ONCHAIN_KIT",
});
console.log(JSON.stringify(message, null, 2));
// Make sure they're following us before they can mint the cNFT
if (isValid && !message.following) {
return new NextResponse(getFrameHtmlResponse({
image: {
src: `${baseURL}/error.jpg`,
aspectRatio: "1:1",
},
buttons: [
{
label: "You need to be following to mint! Click to retry",
action: "post",
},
],
postUrl: `${baseURL}api/frames`,
}));
// Make sure they have a verified Solana address
} else if (isValid && message.interactor.verified_addresses.sol_addresses) {
const solanaAddresses = message.interactor.verified_addresses.sol_addresses;
console.log(`SOLANA ADDRESSES: ${solanaAddresses}`);
if (solanaAddresses.length !== 0) {
try {
console.log(`MINTING to ${solanaAddresses[0]}`);
// We take the first address address, in case there's more than one
const mintResult = await mintCompressedNFT(solanaAddresses[0]!);
return new NextResponse(getFrameHtmlResponse({
image: {
src: `${baseURL}/success.jpg`,
aspectRatio: "1:1",
},
buttons: [
{
label: "Success! View your cNFT on XRAY",
action: "link",
target: `https://xray.helius.xyz/token/${mintResult.assetId}?network=mainnet`
},
],
}));
} catch (e: any) {
console.log(`Minting failed: ${e}`);
return new NextResponse(getFrameHtmlResponse({
image: {
src: `${baseURL}/error.jpg`,
aspectRatio: "1:1",
},
buttons: [
{
label: "Minting failed. Click to retry",
action: "post",
},
],
postUrl: `${baseURL}api/frames`,
}));
}
} else {
console.log(`No Solana address found`);
return new NextResponse(getFrameHtmlResponse({
image: {
src: `${baseURL}/error.jpg`,
aspectRatio: "1:1",
},
buttons: [
{
label: "No Solana address found. Click to retry",
action: "post",
},
],
postUrl: `${baseURL}api/frames`
}));
}
} else {
return new NextResponse(getFrameHtmlResponse({
image: {
src: `${baseURL}/error.jpg`,
aspectRatio: "1:1",
},
buttons: [
{
label: "Invalid frame message. Click to retry",
action: "post",
},
],
postUrl: `${baseURL}api/frames`,
}));
}
}File ini adalah rute API Next.js yang menangani semua permintaan POST untuk frame kita. File dimulai dengan mengimpor NextRequest dan NextResponse dari next/server untuk menangani permintaan masuk dan mengirim respons. Kita juga mengimpor getFrameMessage dan getFrameHtmlResponse dari @coinbase/onchainkit/frame untuk memvalidasi pesan frame dan menghasilkan respons HTML bagi interaksi frame. Kita juga mengimpor fungsi utilitas mintCompressedNFT.
baseURL ditetapkan untuk mengurangi pengulangan kode. Ini digunakan untuk menyusun jalur menuju resource dan endpoint API.
File tersebut mengekspor fungsi POST, yang mengurai isi permintaan masuk untuk mengekstrak pesan frame. Kita menggunakan getFrameMessage untuk memeriksa apakah interaksi frame yang masuk dan payload pesannya valid. Untuk melakukannya, kita meneruskan isi permintaan sebagai JSON dan kunci API Neynar default (yaitu “NEYNAR_ONCHAIN_KIT”). Neynar adalah platform developer yang bertujuan menyederhanakan pengembangan Farcaster. getFrameMessage mengembalikan Promise yang di-resolve menjadi FrameValidationResponse. Tipe ini ditetapkan sebagai:
export type FrameValidationResponse =
| { isValid: true; message: FrameValidationData }
| { isValid: false; message: undefined };Jadi, jika interaksi frame valid, fungsi tersebut mengembalikan pesan bertipe FrameValidationData. Tipe ini ditetapkan sebagai:
export interface FrameValidationData {
button: number; // Number of the button clicked
following: boolean; // Indicates if the viewer clicking the frame follows the cast author
input: string; // Text input from the viewer typing in the frame
interactor: {
fid: number; // Viewer Farcaster ID
custody_address: string; // Viewer custody address
verified_accounts: string[]; // Viewer account addresses
verified_addresses: {
eth_addresses: string[] | null;
sol_addresses: string[] | null;
};
};
liked: boolean; // Indicates if the viewer clicking the frame liked the cast
raw: NeynarFrameValidationInternalModel;
recasted: boolean; // Indicates if the viewer clicking the frame recasted the cast
valid: boolean; // Indicates if the frame is valid
}Data ini sangat berharga karena mencakup informasi relevan seperti ID Farcaster pengguna, apakah mereka memiliki alamat Ethereum atau Solana terverifikasi, dan apakah mereka menyukai cast tersebut. Dalam tutorial ini, kita ingin memeriksa apakah pengguna yang mencoba mencetak telah mengikuti profil saya. Jika sudah, kita akan mengizinkan mereka mencetak cNFT. Kita juga perlu memastikan mereka memiliki alamat Solana terverifikasi yang dapat menjadi tujuan pencetakan cNFT.
Pertama, kita memeriksa apakah interaksi tersebut valid dan apakah pengguna mengikuti akun saya. Jika tidak, mereka akan melihat pesan error dan tombol yang meminta mereka mencoba lagi. Kemudian, kita memeriksa apakah pengguna memiliki alamat Solana terverifikasi. Jika terdapat satu atau beberapa alamat, kita melanjutkan proses pencetakan. Kita mengambil alamat Solana terverifikasi pertama dan meneruskannya ke mintCompressedNFT. Jika berhasil, kita mengembalikan gambar keberhasilan dan link untuk melihat cNFT di Orb. Jika gagal, kita mencatat error dan merespons dengan pesan yang meminta pengguna mencoba lagi. Jika tidak ada alamat Solana terverifikasi, kita merespons dengan pesan error yang menyatakan bahwa alamat Solana terverifikasi tidak tersedia dan meminta pengguna mencoba lagi. Terakhir, jika pesan frame tidak valid, kita merespons dengan pesan error mengenai frame yang tidak valid dan meminta pengguna mencoba lagi.
Kode ini menggunakan getFrameHtmlResponse untuk menghasilkan respons HTML yang disesuaikan dengan hasil spesifik dari proses pencetakan atau pemeriksaan validasi. Ini mencakup pengaturan gambar, rasio aspek, dan tombol dalam respons untuk interaksi pengguna tertentu.
Meluncurkan ke Produksi
Setelah kode selesai, buat repositori GitHub baru dan push kode ke repositori tersebut. Jalankan perintah berikut di command line Anda untuk melakukan push kode ke GitHub:
git add .
git commit -m "Initial commit"
git remote add origin https://github.com/<username>/<new repo name>.git
git branch -M main
git push -u origin mainSetelah melakukan push kode ke GitHub, langkah berikutnya adalah men-deploy aplikasi. Vercel menawarkan integrasi tanpa hambatan dengan GitHub yang menyederhanakan seluruh proses deployment, jadi kita akan menggunakannya. Untuk melanjutkan:
- Masuk ke akun Anda di situs web Vercel. Jika belum memiliki akun, Anda perlu membuatnya—Vercel menyediakan tingkat Hobby yang cukup lengkap (yaitu gratis), dan itu sudah memadai untuk kebutuhan kita
- Setelah masuk, buka dasbor dan klik tombol Proyek Baru. Vercel akan meminta Anda mengimpor proyek dari GitHub. Pilih repositori yang baru saja Anda buat pada langkah sebelumnya
- Vercel akan otomatis mendeteksi framework yang Anda gunakan dan menyarankan pengaturan build. Vercel dibuat oleh para kreator Next.js dan menyediakan dukungan kelas utama, sehingga kita tidak perlu terlalu mencemaskan konfigurasi yang rumit
- Setelah mengonfigurasi pengaturan proyek, klik tombol Deploy. Vercel akan otomatis memulai proses deployment, membangun dan men-deploy proyek ke URL Vercel yang unik.
- Setelah deployment selesai, Vercel akan memberikan URL unik ini agar Anda dapat mengakses aplikasi live. Proyek saya di-build ke https://helius-frame.vercel.app/—nama repositori GitHub diikuti oleh .vercel.app. Vercel juga mendukung konfigurasi domain kustom dalam pengaturan proyek
Selesai! Dengan mengikuti langkah-langkah ini, kita telah melakukan push frame Farcaster ke GitHub dan meng-hosting-nya di Vercel. Anda dapat menguji fungsionalitas frame menggunakan alat pengujian yang telah disebutkan, seperti validator Frames. Kini Anda hanya perlu membuat cast dengan URL frame tersebut!
Kesimpulan
Perpaduan blockchain dan media sosial merupakan lompatan besar dalam cara kita memahami dan berinteraksi di ruang digital. Popularitas Farcaster dan frames mengubah postingan yang sebelumnya statis di platform media sosial tradisional menjadi pengalaman interaktif. Artikel ini membahas Farcaster dan frames. Tutorial yang disediakan merupakan pengantar untuk memanfaatkan dukungan Solana terbaru dari Farcaster guna mencetak cNFT bagi pengguna hanya dengan mengeklik satu tombol. Baik Anda seorang developer yang ingin membuat aplikasi di Farcaster maupun seseorang yang tertarik menjelajahi feed media sosial dengan cara baru dan menarik, kemungkinannya tidak terbatas.
Jika Anda sudah membaca sejauh ini, terima kasih, anon! Jika ingin bergabung dengan Farcaster, gunakan link undangan berikut!
Pastikan Anda memasukkan alamat email di bawah agar tidak melewatkan informasi terbaru tentang Solana. Siap mempelajari lebih lanjut? Jelajahi artikel terbaru di blog Helius dan lanjutkan perjalanan Solana Anda hari ini.
Resource Tambahan
Artikel Terkait
Berlangganan Helius
Ikuti perkembangan terbaru dalam pengembangan Solana dan dapatkan pembaruan saat kami memublikasikan postingan


