Monero

Apa yang Anda butuhkan

Opsi ini untuk orang yang ingin menjalankan node mereka sendiri. Anda juga menjalankan node Monero, dompet view-only, dan pengawas kecil yang selalu-aktif di mesin Anda sendiri. Panduan ini menelusuri semuanya. Jika Anda lebih suka tidak menjalankan apa pun, hubungkan layanan kripto terhosting saja.

Money flow

Kenapa kami meminta setiap kolom

Mint endpoint URL

Saat seorang pembeli mengklik Beli, kami meminta node Anda alamat baru untuk ditampilkan kepada mereka. Permintaan itu menuju satu rute publik ini. Ia mengembalikan sebuah alamat dan tidak lebih; dompet Anda tetap privat di belakangnya.

Webhook secret

Pengawas Anda memberi tahu kami "pesanan ini dibayar" dengan mengirimkan kami pesan yang ditandatangani. Secret bersama ini membiarkan kami memastikan pesannya benar-benar datang dari pengawas Anda, jadi tidak ada yang bisa memalsukan event paid. Ia tidak bisa membaca apa pun dan tidak bisa memindahkan apa pun.

Penyiapan

1. Apa yang akan Anda jalankan

   Tiga hal, semua di mesin Anda sendiri. Tidak ada di sini yang diberikan kepada kami kecuali mint URL publik dan secret bersama.

   • Sebuah node Monero (monerod) dan dompet view-only (monero-wallet-rpc), dijaga privat.
   • Sebuah mint endpoint: satu rute publik kecil yang membagikan alamat baru per pesanan.
   • Sebuah pengawas: program kecil selalu-aktif yang mengawasi dompet Anda dan memberi tahu kami saat pembayaran mendarat.
2. Buat dompet view-only

   Dompet view-only bisa melihat pembayaran masuk dan mencetak alamat penerima baru, tapi tidak bisa membelanjakan. Anda membangunnya dari alamat dompet asli Anda dan private view key-nya, tidak lebih. Itulah yang membiarkan node Anda mendeteksi pembayaran tanpa pernah memegang kuasa untuk memindahkannya.

   Linux macOS Windows

   monero-wallet-cli --generate-from-view-key ~/monero/view-only

   Ia meminta alamat utama Anda dan private view key Anda. Jangan pernah memasukkan seed atau spend key Anda, simpan itu di mesin terpisah. Ia menulis view-only dan view-only.keys; atur kata sandi dan simpan di sebuah berkas (wallet.password, di sebelah dompetnya) untuk langkah berikutnya.

3. Jalankan node Monero Anda

   Daemon-nya menyinkronkan dan menyimpan blockchain. Jalankan sebagai layanan (systemd atau Docker) agar ia memulai ulang sendiri. RPC-nya mendengarkan di 127.0.0.1:18081.

   Linux macOS Windows

   monerod --data-dir ~/.bitmonero --prune-blockchain --restricted-rpc

   Node yang dipangkas menjaga jejak disk tetap kecil dan tetap melihat setiap pembayaran masuk. Node-nya menjangkau jaringan tapi tidak mengekspos apa pun secara publik.

4. Jalankan wallet RPC

   Layanan kedua yang membuka dompet view-only dan menjawab mint endpoint serta pengawas. Arahkan ke node Anda dan ikat ke localhost. Jalankan sebagai layanan juga.

   Linux macOS Windows

   monero-wallet-rpc \
     --wallet-file ~/monero/view-only \
     --password-file ~/monero/wallet.password \
     --rpc-bind-ip 127.0.0.1 --rpc-bind-port 18083 \
     --daemon-address 127.0.0.1:18081 --trusted-daemon \
     --disable-rpc-login

   Jangan pernah mengekspos wallet RPC ke internet publik; ikat ke localhost atau jaringan privat. --disable-rpc-login hanya aman karena ia khusus-localhost; pakai --rpc-login jika ia bisa dijangkau dari tempat lain. Hanya mint endpoint di bawah yang publik.

5. Pasang paket Coin Moebius Monero

   Ia menyediakan pencetak alamat, penanda tangan webhook, dan pengawas, jadi Anda hampir tidak menulis kode. Jalur tercepat adalah contoh siap-jalan di bawah: salin folder-nya, isi empat nilai, dan jalankan.

   npm install @aquarian-metals/coin-moebius-monero

   Paketnya di npm ↗Contoh siap-jalan (node, mint endpoint, pengawas) ↗

6. Hasilkan webhook secret Anda

   Sebuah nilai acak kuat yang menandatangani dan memverifikasi webhook. Dua cara membuatnya, pilihan Anda: klik Generate saat Anda menambah penyedianya di dasbor (ia berjalan di browser Anda, tidak pernah di server kami), atau jalankan perintah di bawah sendiri. Bagaimanapun juga, tempel nilai yang sama di pengawas Anda dan di dasbor.

   Linux macOS Windows

   openssl rand -hex 32

7. Berdirikan mint endpoint

   Satu rute POST publik yang menjadi muka dompet Anda. Ia memakai createMoneroCreator dari paketnya untuk mencetak alamat baru per pesanan. Inilah satu-satunya hal yang Anda ekspos ke internet, dan aman diekspos: ia mengembalikan alamat penerima dan tidak memindahkan uang.

   // POST /coin-moebius/monero/mint
   import { createMoneroCreator } from '@aquarian-metals/coin-moebius-monero/server';
   
   const mint = createMoneroCreator({
     walletRpcUrl: 'http://127.0.0.1:18083/json_rpc',
     store: myStore,
     xmrPerUnit: async (cur) => (cur === 'XMR' ? 1 : await myPriceFeed(cur)),
   });
   // return mint({ productId, amount, currency, metadata }) as JSON

   Anda memilih dari mana harga berasal. Coin Moebius tidak pernah memanggil oracle harga.

8. Jalankan pengawas dan arahkan ke kami

   Pengawas adalah program selalu-aktif yang memeriksa dompet Anda setiap beberapa detik dan menandatangani pesan kepada kami saat sebuah pembayaran terkonfirmasi. Atur webhook URL-nya ke alamat proyek Anda (di bawah) dan secret-nya ke nilai yang Anda hasilkan. Jalankan di sebelah dompet Anda, di bawah systemd atau Docker.

   import { createMoneroIndexer } from '@aquarian-metals/coin-moebius-monero/server';
   
   const watcher = createMoneroIndexer({
     walletRpcUrl: 'http://127.0.0.1:18083/json_rpc',
     store: myStore,
     webhookUrl: process.env.MONERO_WEBHOOK_URL,   // your Coin Moebius URL, below
     hmacSecret: process.env.MONERO_HMAC_SECRET,   // the secret you generated
     requiredConfirmations: 10,
   });
   watcher.start();

   Resep pengawas: indexer.js + unit systemd + docker-compose ↗

   Ia menyusul sejak dirancang. Jika ia offline sejenak, jalannya berikutnya melihat pembayaran yang terlewat dan memberi tahu kami saat itu. Server rumah pun cukup; Anda tidak butuh uptime sempurna.

9. URL webhook Anda

   Atur webhookUrl pengawas ke alamat proyek Anda. Id proyek Anda ada di pengaturan proyek di dasbor.

   https://api.coinmoebius.com/webhook/monero/<your project id>

10. Hubungkan di dasbor

    Tambah penyedia, pilih Jadi penyedia Anda sendiri, lalu Monero. Tempel mint endpoint URL Anda dan webhook secret. Itulah semua yang kami simpan, dan tidak satu pun nilai itu bisa menyentuh dompet Anda.

Setelah Anda menghubungkan

Tidak ada sandbox untuk node yang di-host sendiri, jadi pembayaran sungguhan kecil pertama Anda adalah ujinya:

1. Buat sebuah produk dan taruh tombol beli di sebuah halaman (berkas HTML lokal pun berfungsi) yang menunjuk ke proyek Anda.
2. Bayar jumlah kecil Monero dari dompet Anda sendiri.
3. Tunggu konfirmasi. Monero butuh sekitar dua puluh menit untuk terkonfirmasi penuh, sejak dirancang.
4. Buka tab Transaksi. Saat baris baru mencapai succeeded, mint endpoint, pengawas, dan secret Anda semuanya berfungsi dari ujung ke ujung.

Pemecahan masalah

Checkout gagal seketika.

Kami tidak bisa menjangkau mint endpoint Anda. Pastikan ia URL https publik dan node Anda online. Dasbor menampilkan ini sebagai pesan keterjangkauan saat Anda menyimpan.

Pembeli membayar tapi pesanan tetap pending.

Entah pengawasnya tidak berjalan, atau secret-nya tidak cocok. Pastikan proses pengawas aktif dan bahwa MONERO_HMAC_SECRET-nya adalah nilai persis yang Anda tempel ke dasbor.

Pembayarannya butuh waktu untuk muncul.

Itu normal. Monero terkonfirmasi melalui beberapa blok; pengawas menunggu sepuluh konfirmasi (sekitar dua puluh menit) sebelum melaporkan keberhasilan.

Baik untuk diketahui

Simpan dompet view-only di mesin yang aktif. Pengawas hanya perlu melihat pembayaran masuk. Simpan spend key Anda di mesin terpisah dan offline, lalu sapu dana dari sana.

Jangan pernah mengekspos wallet RPC. Hanya mint endpoint yang publik. Ikat wallet RPC ke localhost atau jaringan privat setiap saat.

Waktu mati itu murah. Pengawas menyusul setelah gangguan dan melaporkan pembayaran yang terlewat. Tidak ada yang hilang.

Memutar secret. Hasilkan secret baru kapan saja, lalu tempel ke pengawas dan ke dasbor.

Monero circular economy

• Coin Moebius on XMRList
• Review Coin Moebius on Monerica

Ada pertanyaan? Join our Discord