sarana / rpc
Laravel package to interact with blockchain RPC nodes (e.g. Ethereum, BSC) using Tatum API
Installs: 27
Dependents: 0
Suggesters: 0
Security: 0
Stars: 0
Watchers: 0
Forks: 0
Open Issues: 0
pkg:composer/sarana/rpc
Requires
- kornrunner/ethereum-address: ^0.3.0
- kornrunner/ethereum-offline-raw-tx: ^0.8.0
- web3p/ethereum-util: ^0.1.4
README
Library Laravel untuk interaksi dengan node blockchain (BSC, Ethereum, dll) via RPC. Memudahkan pengembangan aplikasi yang membutuhkan komunikasi dengan jaringan blockchain tanpa harus mengelola node sendiri secara langsung.
Instalasi
jalankan perintah berikut untuk menginstall package:
composer require sarana/rpc
Konfigurasi
Setelah instalasi, publish konfigurasi package dengan perintah:
php artisan vendor:publish --provider="Sarana\Blockchainrpc\SaranaRpcServiceProvider" --tag="saranarpc-config"
Kemudian, tambahkan konfigurasi koneksi RPC di file .env
:
TATUM_RPC_URL=
TATUM_RPC_KEY=
CHAIN_ID=
Sesuaikan TATUM_RPC_URL
, TATUM_RPC_KEY
, CHAIN_ID
sesuai kebutuhan aplikasi Anda.
Fitur
- Cek saldo native coin (BNB, ETH, dll) dengan
cekBalance
- Cek saldo token ERC20/BEP20 dengan
cekTokenBalance
- Mengirim transaksi blockchain dengan
sendTransaction
- Mendapatkan detail transaksi dan statusnya
- Mendukung berbagai jaringan blockchain yang kompatibel dengan RPC Ethereum
Contoh Penggunaan
Cek Saldo Native Coin
use Sarana\Rpc\SaranaRpc; $sarana = new SaranaRpc(); $address = '0xYourWalletAddress'; $balance = $sarana->cekBalance($address); echo "Saldo native coin: " . $balance . " wei";
Cek Saldo Token ERC20/BEP20
$tokenAddress = '0xTokenContractAddress'; $address = '0xYourWalletAddress'; $tokenBalance = $sarana->cekTokenBalance($address, $tokenAddress); echo "Saldo token: " . $tokenBalance;
Kirim Transaksi
$from = '0xYourWalletAddress'; $privateKey = 'your-private-key'; $to = '0xRecipientAddress'; $value = '1000000000000000000'; // 1 ETH atau BNB dalam wei $gasLimit = "default (2100)"; $gasPriceGwei = "default (5)"; $txHash = $sarana->sendTransaction($sendFrom,$sendTo,$privateKey,$amount,$gasLimit,$gasPriceGwei); echo "Transaksi dikirim dengan hash: " . $txHash;
Kirim Token ERC20/BEP20
$smartcontract = '0xYourWalletAddress'; $from = '0xYourWalletAddress'; $privateKey = 'your-private-key'; $to = '0xRecipientAddress'; $amount = '10'; // jumlah token dalam satuan normal (misalnya 10 token) $gasLimit = "default (2100)"; $gasPriceGwei = "default (5)"; $txHash = $sarana->sendTokenTransaction($sendFrom,$sendTo,$privateKey,$smartcontract,$amount,$gasLimit,$gasPriceGwei); echo "Token berhasil dikirim dengan hash: " . $txHash;
Format Respon
-
cekBalance($address)
Mengembalikan saldo dalam satuan wei sebagai string. -
cekTokenBalance($address, $tokenAddress)
Mengembalikan saldo token dalam satuan terkecil token (biasanya wei) sebagai string. -
sendTransaction($from, $privateKey, $to, $value)
Mengembalikan hash transaksi (string
) jika berhasil mengirim transaksi, ataunull
jika gagal. -
sendTokenTransaction($from, $privateKey, $to, $amount)
Mengembalikan hash transaksi token sebagaistring
jika berhasil, atau pesan kesalahan jika gagal.
Untuk informasi lebih lanjut dan dokumentasi lengkap, silakan lihat kode sumber dan contoh penggunaan di repository.
Daftar Fungsi Tersedia
Berikut adalah fungsi-fungsi publik yang tersedia pada kelas SaranaRpc
beserta deskripsi dan parameternya:
cekBalance
Mengecek saldo native coin (seperti ETH, BNB) dari sebuah alamat wallet.
Signature:
public function cekBalance(string $address): string
Parameter:
address
(string
): Alamat wallet yang akan dicek saldonya.
Return:
Saldo dalam satuan wei sebagai string.
cekTokenBalance
Mengecek saldo token ERC20/BEP20 dari sebuah alamat wallet.
Signature:
public function cekTokenBalance(string $address, string $tokenAddress): string
Parameter:
address
(string
): Alamat wallet yang akan dicek saldonya.tokenAddress
(string
): Alamat kontrak token ERC20/BEP20.
Return:
Saldo token dalam satuan terkecil token (biasanya wei) sebagai string.
sendTransaction
Mengirim transaksi native coin dari satu alamat ke alamat lain.
Signature:
public function sendTransaction(string $from, string $to, string $privateKey, string $value, $gasLimit = null, $gasPriceGwei = null): ?string
Parameter:
from
(string
): Alamat wallet pengirim.to
(string
): Alamat tujuan.privateKey
(string
): Private key dari wallet pengirim.value
(string
): Jumlah native coin yang akan dikirim (dalam satuan wei).gasLimit
(int|string|null
, opsional): Batas gas untuk transaksi (default: 21000 jika tidak diisi).gasPriceGwei
(int|string|null
, opsional): Harga gas dalam satuan Gwei (default: 5 jika tidak diisi).
Return:
Hash transaksi (string
) jika berhasil, atau null
jika gagal.
sendTokenTransaction
Mengirim token ERC20/BEP20 dari satu alamat ke alamat lain.
Signature:
public function sendTokenTransaction(string $from, string $to, string $privateKey, string $contractAddress, string $amount, $gasLimit = null, $gasPriceGwei = null): string
Parameter:
from
(string
): Alamat wallet pengirim.to
(string
): Alamat tujuan.privateKey
(string
): Private key dari wallet pengirim.contractAddress
(string
): Alamat kontrak token ERC20/BEP20.amount
(string
): Jumlah token yang akan dikirim dalam satuan normal (bukan wei).gasLimit
(int|string|null
, opsional): Batas gas untuk transaksi (default: 21000 jika tidak diisi).gasPriceGwei
(int|string|null
, opsional): Harga gas dalam satuan Gwei (default: 5 jika tidak diisi).
Return:
Hash transaksi token sebagai string
jika berhasil, atau pesan kesalahan jika gagal.
getBlock
Mendapatkan block height (ketinggian blok) terbaru dari blockchain.
Signature:
public function getBlock(): array
Return:
Array dengan format ['message' => 'success', 'data' => (int) blockNumber]
atau ['message' => 'failed', 'data' => '...']
getTransactionByHash
Mengambil informasi detail transaksi berdasarkan hash.
Signature:
public function getTransactionByHash(string $txHash): array
Parameter:
txHash
(string
): Hash transaksi yang ingin dicek.
Return:
Array terstruktur dengan informasi seperti:
hash
from
to
amount
confirmation
transaction_type
(coin
atautoken
)token_amount
smartcontract
getTransactionReceipt
Mengambil receipt dari transaksi untuk mengecek status berhasil/gagal.
Signature:
public function getTransactionReceipt(string $txHash): array
Parameter:
txHash
(string
): Hash transaksi yang ingin dicek.
Return:
Detail receipt dalam format array Laravel, atau error jika gagal.
createAddress
Membuat wallet Ethereum/BSC baru lengkap dengan public address dan private key.
Signature:
public function createAddress(): array
Return:
Array dengan struktur:
address
(string
): Alamat publik walletprivateKey
(string
): Private key dalam format heksadesimal
importAccount
Mengimpor akun wallet dari private key untuk mendapatkan public address-nya.
Signature:
public function importAccount(string $privateKey): array
Parameter:
privateKey
(string
): Private key dari wallet yang ingin diimpor
Return:
Array dengan struktur:
address
(string
): Alamat publik walletprivateKey
(string
): Private key yang sama