توثيق API | Nabdchain

API

استخدم API العام لقراءة السلسلة، والبحث عن الحسابات، وإرسال المعاملات الموقعة، وعمليات الأصول، وسجلات AP، والتحقق من النهائية.

Base APIhttps://api.testnet.nabdchain.org/api/v1

OpenAPIhttps://testnet.nabdchain.org/api/openapi.yaml

SDK repositorygitlab.com/ktham33n1/nabd-sdk

Explorerhttps://testnet.nabdchain.org

هوية السلسلةاقرأ network_id و genesis_hash قبل التوقيع.

عائلات نقاط النهاية

الطريقة	المسار	الغرض
GET	`/api/status`	هوية الشبكة وحالة الإجماع
GET	`/api/v1/blocks`	البلوكات الأخيرة والبحث عن بلوك
GET	`/api/v1/accounts/{address}`	الرصيد، nonce، ونشاط الحساب
POST	`/api/v1/transactions`	إرسال معاملة موقعة
POST	`/api/v1/transactions/batch`	إرسال 1-250 معاملة موقعة مع نتيجة لكل عنصر
GET	`/api/v1/assets`	سرد الأصول وفحصها
GET	`/api/v1/ap/contracts`	سرد البرامج المستقلة
POST	`/api/v1/faucet/requests`	طلب رموز شبكة الاختبار العامة

SDK

استخدم مستودع SDK العام لعملاء Python وTypeScript، ونسخة OpenAPI، والأمثلة، وملاحظات الإصدارات.

المورد	الرابط	الاستخدام
Getting started	GETTING_STARTED.md	التثبيت، قراءة الشبكة، طلب رصيد الاختبار، التوقيع، الإرسال، والتحقق من النهائية.
Python SDK	python/	توقيع Ed25519 محلي، تحويلات، أصول، استدعاءات AP، والتحقق من النهائية.
TypeScript SDK	typescript/	تكامل Node.js 18+ للمحافظ واللوحات والخدمات.
OpenAPI	openapi.yaml	توليد عملاء للغات أخرى من العقد المباشر.
Release flow	RELEASE.md	مسار الصيانة للنشر على PyPI وnpm ووسوم Git وبوابات CI.

# Repository
git clone https://gitlab.com/ktham33n1/nabd-sdk.git

# Python
cd nabd-sdk
python3 -m pip install -e ./python
python3 python/examples/read_chain.py

# TypeScript
cd typescript
npm install
npm run build

التوقيع

لمعاملات Ed25519، ابن حمولة التوقيع من حقول البروتوكول أدناه فقط، احذف الحقول غير الموجودة، ثم استخدم JSON متعارفا عليه بترميز UTF-8 وترتيب مفاتيح معجمي وفواصل مضغوطة.

from, to, amount, fee, nonce, timestamp, data, pubkey, privacy, type,
expires_at, version, network_id, genesis_hash

timestamp هو وقت Unix بالثواني. تقبل العقد معاملات موقعة من 3600 ثانية في الماضي حتى 300 ثانية في المستقبل. لا توقع بيانات الاستجابة مثل tx_hash أو status أو block_round أو حقول العرض في المستكشف.

الرسوم

المبالغ والرسوم في API أعداد صحيحة بوحدة micro-NABD مع 6 منازل عشرية.

1 NABD = 1_000_000 micro-NABD
0.001 NABD = 1_000 micro-NABD

العملية	الحد الأدنى للرسوم
تحويل عادي أو خاص أو عنصر داخل دفعة	`1,000` micro-NABD
عملية أصل	`1,000` micro-NABD
نشر AP	`100,000` micro-NABD
استدعاء AP	`10,000` micro-NABD

الصنبور

استخدم الصنبور العام لتمويل محافظ NABD1 الخاصة باختبارات SDK والمحافظ والأصول و AP.

curl -sS -X POST https://testnet.nabdchain.org/api/v1/faucet/requests \
  -H "Content-Type: application/json" \
  --data '{"address":"NABD1...","email":"dev@example.com","note":"wallet test","captcha_token":"TOKEN_FROM_FAUCET_PAGE"}'

Reference AP

يوجد برنامج AP مرجعي مباشر على شبكة الاختبار لفحص دورة النشر والتنفيذ.

Contract52874a94e69f2a9713427ee760d2b84811241b16

Deploy tx51aac251ec1f9ce815f501575a86e6053833e559f88997a8933ef72c63283d6d

Call tx4e6fc90dffc7c70b2720f3219aa7483db465ff0cee892009780dbb9448d3f01b

Functionping، ناجحة، واستخدمت وحدة تنفيذ واحدة.

curl -sS https://api.testnet.nabdchain.org/api/v1/ap/contracts/52874a94e69f2a9713427ee760d2b84811241b16
curl -sS https://api.testnet.nabdchain.org/api/v1/ap/contracts/52874a94e69f2a9713427ee760d2b84811241b16/executions

الأمثلة

# هوية السلسلة
curl -sS https://api.testnet.nabdchain.org/api/status

# البلوكات الأخيرة
curl -sS "https://api.testnet.nabdchain.org/api/v1/blocks?limit=5"

# البحث عن حساب
curl -sS "https://api.testnet.nabdchain.org/api/v1/accounts/NABD1..."

# إرسال معاملة موقعة
curl -sS -X POST https://api.testnet.nabdchain.org/api/v1/transactions \
  -H "Content-Type: application/json" \
  --data '{"from":"NABD1...","to":"NABD1...","amount":1000,"fee":1000,"nonce":1,"timestamp":1779890000,"type":"transfer","data":"","pubkey":"...","network_id":"NETWORK_ID_FROM_STATUS","genesis_hash":"GENESIS_HASH_FROM_STATUS","signature":"..."}'

# التحقق من النهائية
curl -sS "https://api.testnet.nabdchain.org/api/v1/transactions/TX_HASH_FROM_SUBMIT_RESPONSE"

توثيق مطوري NABD

API