Solinkify adalah infrastruktur pembayaran terdesentralisasi di jaringan Solana yang dirancang untuk menjembatani aset digital dengan Merchant (E-commerce) dan Autonomous AI Agents (M2M).

Proyek ini menggabungkan Smart Contract Anchor, Backend Rust (Axum) untuk skalabilitas off-chain, dan SDK JavaScript yang plug-and-play.

🚀 Fitur Utama

DePIN Payment Gateway: Memungkinkan merchant pihak ketiga menerima SOL dengan sistem fee-splitting otomatis.
Protokol x402 (M2M): Standar baru untuk agen AI agar dapat membeli aset digital secara otonom.
Solana Blinks Ready: Mendukung integrasi transaksi langsung melalui media sosial (Twitter/X).
Idempotensi & Keamanan: Perlindungan terhadap Replay Attacks menggunakan verifikasi tanda tangan on-chain dan off-chain.

📦 Instalasi SDK

Gunakan NPM atau Yarn untuk mengintegrasikan Solinkify ke dalam proyek Anda:

npm install solinkify-sdk

🛠 Panduan Integrasi untuk Merchant (E-commerce)

Merchant dapat menerima pembayaran Solana tanpa perlu memikirkan kerumitan perakitan transaksi Web3.

Opsi A: Vanilla JavaScript / Node.js

Cocok untuk HTML dasar atau sistem backend sederhana.

import { SolinkifyMerchant } from 'solinkify-sdk';

const merchant = new SolinkifyMerchant();

async function handlePayment() {
    // 1. Dapatkan transaksi siap pakai dari Solinkify
    const tx = await merchant.createPaymentTransaction(
        "DOMPET_TOKO_ANDA",
        "DOMPET_PEMBELI",
        0.1,             // Jumlah SOL
        "ORDER-12345"    // ID Pesanan
    );

    // 2. Minta persetujuan dompet pembeli (Phantom, dll)
    const provider = window.phantom?.solana;
    const { signature } = await provider.signAndSendTransaction(tx);
    
    console.log("Pembayaran Berhasil! TxID:", signature);
}

Opsi B: React / Next.js (dengan Solana Wallet Adapter)

Integrasi langsung ke dalam tombol checkout di frontend modern Anda.

import { useWallet } from '@solana/wallet-adapter-react';
import { Connection } from '@solana/web3.js';
import { SolinkifyMerchant } from 'solinkify-sdk';

export default function CheckoutButton() {
    const { publicKey, sendTransaction } = useWallet();
    // Diatur ke Devnet untuk fase testing/development
    const connection = new Connection("[https://api.devnet.solana.com](https://api.devnet.solana.com)");

    const handleCheckout = async () => {
        if (!publicKey) return alert("Silakan hubungkan dompet (wallet) Anda terlebih dahulu!");

        try {
            const merchantApi = new SolinkifyMerchant();
            
            // 1. Generate transaksi dari SDK Solinkify
            const tx = await merchantApi.createPaymentTransaction(
                "DOMPET_TOKO_ANDA", 
                publicKey.toBase58(), 
                0.1, 
                "INV-REACT-001"
            );

            // 2. Eksekusi transaksi via Wallet Adapter bawaan DApp
            const signature = await sendTransaction(tx, connection);
            alert(`Pembayaran Sukses! TxID: ${signature}`);
            
        } catch (error) {
            console.error("Gagal melakukan pembayaran:", error);
        }
    };

    return (
        <button 
            onClick={handleCheckout} 
            style={{ background: '#9945FF', color: 'white', padding: '10px 20px', borderRadius: '8px', cursor: 'pointer' }}
        >
            Bayar 0.1 SOL (Devnet) via Phantom
        </button>
    );
}

🤖 Panduan Integrasi untuk AI Agents (M2M Autonomy)

Protokol x402 Solinkify memungkinkan AI membeli data atau API secara mandiri tanpa intervensi manusia. SDK ini menangani negosiasi HTTP 402 Payment Required, pembayaran blockchain, dan verifikasi kriptografi di belakang layar.

import { SolinkifyAgent } from 'solinkify-sdk';

// Inisialisasi dengan Private Key AI (Base58)
const agent = new SolinkifyAgent("YOUR_AI_PRIVATE_KEY_BASE58");

async function buyDigitalAsset() {
    try {
        // Otomatis: Dapatkan Invoice -> Bayar On-Chain -> Sign Kriptografi -> Download URL
        const downloadUrl = await agent.purchaseAndDownload("ID_ASSET_DIGITAL");
        console.log("✅ Aset berhasil dibeli. Tautan unduhan:", downloadUrl);
    } catch (error) {
        console.error("❌ Gagal membeli aset:", error.message);
    }
}

⛓ Informasi Protokol (On-Chain)

Program ID: AaKvuhidmnrpXdHi762sJ1xZ5TrjragS9Y6ikwFVp1tr
Jaringan: Solana Devnet (Fase Testing)
Tokenomics Gateway (DePIN):
- Base Fee: 1% (Minimal: 0.00015 SOL, Maksimal Cap: 0.05 SOL).
- Revenue Split: 75% diteruskan ke Operator Node, 25% diteruskan ke Solinkify Admin.

🌐 API Reference (Off-Chain)

Base URL: https://api.solinkify.com/api

Endpoint	Method	Deskripsi
`/gateway/create-payment`	`POST`	Membuat transaksi unsigned M2M dengan instruksi split fee untuk Merchant.
`/x402/book/:id`	`GET`	Meminta invoice atau mengunduh aset (Membutuhkan 3 Security Headers).
`/actions/buy/:id`	`GET/POST`	Endpoint native untuk standard Solana Blinks.
`/books`	`GET`	Mengambil daftar aset digital yang live di database.

🛡 Keamanan (Security Headers)

Jika Anda tidak menggunakan modul SolinkifyAgent dan melakukan pemanggilan API secara manual, Anda wajib menyertakan 3 header ini pada request GET kedua (setelah pembayaran on-chain selesai) untuk mengklaim file:

x-payment-signature: TxID (Signature) dari bukti transfer SOL Anda di jaringan Solana.
x-buyer-pubkey: Public Key dompet yang digunakan untuk membayar.
x-auth-signature: Tanda tangan kriptografi (Ed25519) dari pesan yang berisi string ${book_id}:${signature} menggunakan private key pembeli.