Brale Baru-baru ini kami merilis versi terbaru dari API stablecoin. Proyek ini dimulai dengan tahap perancangan pada kuartal pertama, dilanjutkan ke tahap pengembangan pada kuartal kedua, dan akhirnya diluncurkan ke lingkungan produksi untuk pelanggan sungguhan tak lama setelahnya.

Ada banyak hal yang dapat dilakukan oleh API. Postingan ini bukanlah uraian mendetail mengenai semua fungsionalitas tersebut. Ini hanyalah catatan tentang bagaimana saya telah menguji berbagai hal, sebagian besar untuk bersenang-senang, dan sebagian lagi untuk memahami bagaimana orang lain mungkin mendekatinya saat pertama kali menggunakannya.

Menggunakan LLM untuk Menjelajahi API

Terakhir kali saya mengerjakan proyek serupa, model bahasa besar belum benar-benar menjadi bagian dari alur kerja. Kini situasinya telah berubah. Dengan Cursor dan beberapa perintah yang tepat, kini mudah untuk merangkai prototipe yang berfungsi dan menguji asumsi secara real-time.

Saya masih suka menggunakan Postman untuk menjelajahi API, tetapi saya ingin merasakan bagaimana rasanya menggunakan Brale API dalam antarmuka yang lebih mirip dengan antarmuka nyata.

Uji Coba Pertama: Otentikasi

Saya memulai dengan alur otentikasi dasar—menggunakan client_id dan client_secret untuk mendapatkan token bearer. Tidak ada yang istimewa. Cukup untuk membuktikan bahwa kredensial berfungsi dan cakupannya tepat.

Uji coba kecil tersebut dapat dilihat di sini: github.com/superduperdot/auth-app

Uji Coba Kedua: Saldo

Ternyata ini sedikit lebih rumit. Brale API mendukung berbagai jenis nilai (masing-masing mewakili aset yang berbeda) dan berbagai jenis transfer (masing-masing mewakili rantai atau jaringan). Jadi, proses untuk mengambil saldo berjalan seperti ini:

  • Dapatkan account_id yang terkait dengan kredensial Anda

  • Gunakan ID tersebut untuk mengambil daftar alamat

  • Saring hasil berdasarkan jenis: “internal” untuk mengisolasi dompet kustodian

  • Lakukan iterasi melalui setiap kombinasi jenis nilai dan jenis transfer yang diketahui

  • Periksa saldo dan catat hasilnya

Aplikasi tersebut ada di sini: github.com/superduperdot/balance-app

Mencari Tipe yang Didukung

Jenis Transfer (TransferTypes) telah didokumentasikan dengan baik. Jenis Nilai (ValueTypes) belum diungkapkan secara langsung dalam dokumentasi, jadi saya mengambilnya dari aplikasi yang sedang berjalan dan mengunggah kedua daftar tersebut ke GitHub untuk referensi di masa mendatang:

  • Daftar TransferTypes Brale

  • Daftar ValueTypes Brale

Mendapatkan harga dari titik akhir data juga berjalan dengan baik.

Pengamatan Lain

  • Jika Anda menjalankan aplikasi secara lokal, kemungkinan akan menghadapi masalah CORS; gunakan proxy.

  • Proses otentikasi dilakukan di auth.brale.xyz; semua hal lainnya dilakukan di api.brale.xyz.

  • Perbedaan antara dan masih menimbulkan bug kecil bagi saya jika saya tidak berhati-hati.

  • Aplikasi uji coba ini menyimpan kredensial secara lokal dan tidak aman untuk penggunaan produksi. Hal ini disengaja

Tidak ada yang final di sini. Pengujian ini sebagian besar berfokus pada kecepatan dan kemudahan penggunaan. Tujuannya adalah untuk melihat seberapa cepat Anda dapat beralih dari kredensial ke sesuatu yang nyata, tanpa bergantung pada alat internal atau pengetahuan mendalam tentang platform.

Jika Anda sedang menjelajahi Brale API, mungkin ini dapat mempersingkat prosesnya. Jika tidak, tetap saja waktu yang dihabiskan untuk melihat bagaimana lapisan baru ini berperilaku di lingkungan nyata sangat berharga. CLI juga dapat membantu untuk menguji fungsionalitasnya.