ABI і дані виклику

Виклик контракту — це транзакція на адресу .app, поле data якої містить виклик. Канонічний формат — JSON у UTF-8:

{"function":"transfer","args":{"to":"neuro:bob.human","amount":"250"}}

У транзакції data містить цей JSON рядком (hex-кодування теж приймається). Нода передає байти експорту контракту call(input_ptr, input_len).

Правила

Правило	Чому
Назву методу передавайте в function.	Старі контракти приймали й method; у новому коді не треба.
Ідентичність — від хоста. Викликайте get_caller(); ігноруйте поле caller у JSON.	У JSON будь-хто може записати будь-який caller. Значення хоста — перевірений підписант транзакції (або контракт, що викликає, у міжконтрактному виклику).
Надсилайте компактний JSON. Без пробілів після : і , — як дає JSON.stringify.	Невеликі no_std-контракти шукають аргументи побайтовим пошуком "key":; пробіли це ламають.
Суми — десятковими рядками в цілих токенах: "amount":"250".	Нода їх переводить (див. нижче); рядки не втрачають точності в JavaScript.
Назви аргументів у args мають бути унікальними.	Побайтовий пошук знаходить перше "key": будь-де в даних, тож args можна передати й на верхньому рівні.

Суми переводить нода

Перш ніж виклик дійде до контракту, нода переписує за вас один аргумент:

• Виклики контрактів: args.amount, заданий десятковим рядком чи числом, вважається сумою в цілих токенах і переводиться в найменші одиниці за decimals контракту ("250" при 6 знаках → 250000000).
• Розгортання: init_args.total_supply переводиться так само за init_args.decimals, який має бути числом JSON (рядок читається як 0 знаків).

Усі інші аргументи доходять до контракту без змін. Людську суму контракт не бачить ніколи.

Прикріплена сума

value транзакції (в uNRO) зараховується на акаунт контракту після успішного виклику. Якщо виклик перервався чи вичерпав fuel, сума лишається у відправника. Host-функції, яка повідомила б контракту прикріплену суму, поки немає; якщо вона потрібна, контракт може порівняти get_balance() до і після або прийняти суму аргументом і перевірити її.

Результат і помилки

Контракт повертає байти через set_return(ptr, len). За домовленістю:

{"ok":"<value>"}            // успіх
{"error":"Unknown function"}  // помилка, яку повідомив контракт

Контракт, що перервався (unreachable, вичерпано fuel, доступ за межі пам'яті), робить транзакцію невдалою: зміни сховища відкочено, сума не переміщена, комісія й nonce витрачені. Статус: failed.

Прочитати результат без транзакції:

curl -s -X POST "$GATEWAY/api/v1/contracts/neuro:<10 hex>.app/call" \
  -H 'Content-Type: application/json' \
  -d '{"function":"balance_of","args":{"address":"neuro:<15 hex>.human"},"dry_run":true}'

У відповіді — success, return_data, gas_used і події, які виклик створив би. Записуючі виклики через цей ендпоінт (dry_run: false) відхиляються, коли нода працює з CHAIN_ENV=mainnet; надсилайте транзакцію.

Конструктор і initialize

• Експорт init, якщо є, виконується один раз під час розгортання.
• Якщо розгортання містить init_args, контракт потім викликається з {"function":"initialize", …init_args} — аргументи на верхньому рівні. Див. Розгортання контрактів.

Стандартні інтерфейси

Інтерфейс — це задокументований набір методів, а не додаткові WASM-експорти: контракт реалізує його, відповідаючи на назви функцій.

NRC-20 (взаємозамінний токен)

Реалізовано в neurochain/contracts/nrc20. Усередині контракту кожна сума — ціле число в найменших одиницях токена; надсилайте amount у цілих токенах, нода переведе (див. вище).

Функція	Аргументи	Примітки
initialize	name, symbol, decimals, total_supply	Один раз; випускає всю пропозицію тому, хто викликав, і робить його owner
name, symbol, decimals, total_supply	—	Читання
balance_of	address	Читання
transfer	to, amount	Від того, хто викликав
approve	spender, amount
allowance	owner, spender	Читання
transfer_from	from, to, amount	Витрачає дозвіл, наданий тому, хто викликав
mint	to, amount	Лише власник
burn	amount	Від того, хто викликав
owner	—	Читання

Приймаються також назви в camelCase (balanceOf, totalSupply, transferFrom). Перекази створюють подію Transfer.

Інші інтерфейси в репозиторії: сертифікати в стилі NRC-721 (ncert) і DAO-управління (dao, gov_dao); їхні ABI-файли лежать поруч з кодом (*.abi.json).

Міжконтрактні виклики

Контракт може викликати інший через host-функцію call_contract, до 8 рівнів вкладеності (MAX_CALL_DEPTH). Усередині викликаного get_caller() повертає адресу контракту, що викликав. Див. Міжконтрактні виклики.