BARU: Solana Privacy Rings kini tersedia di mainnet
Solana Frames: Mencetak cNFT di Farcaster
Blog/Pengembangan

Solana Frames: Mencetak cNFT di Farcaster

Developer Experience Engineer0xIchigo di X0xIchigo di LinkedIn0xIchigo di GitHub
Bacaan 12 menit

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:

Kode
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:

Kode
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:

Kode
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 postUrl yang 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:

Kode
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:

Kode
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:

Kode
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:

Kode
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:

Kode
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 main

Setelah 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

Berlangganan Helius

Ikuti perkembangan terbaru dalam pengembangan Solana dan dapatkan pembaruan saat kami memublikasikan postingan

Gambar diperbesar