Smart Contract Architecture

Здесь опубликованы полные исходные тексты контрактов Nexelorant Account и сделок CPP в Affaire, а также связанных фабрик, сообщений и констант. Каждый файл доступен для чтения целиком.

Для каждого файла указана SHA-256 опубликованных байтов: по ней можно сверить свою копию с файлом на этой странице. Контрольная сумма сама по себе не подтверждает соответствие исходника развёрнутому контракту. При расхождении определяющим является код и состояние конкретного контракта в блокчейне; соответствие исходников проверяется отдельно.

/

Основа

Nexelorant Account

Nexelorant Account — программируемый аккаунт с адресом владельца и его публичным ключом. Контракт проверяет предусмотренную авторизацию и отправляет команды привязанному jetton-кошельку. Его роль следует отличать от контракта сделки CPP, который хранит состояние конкретной сделки и управляет её расчётом.

Группа включает контракт аккаунта и фабрику его развёртывания, а также четыре файла сообщений и констант. В них описаны принимаемые сообщения, параметры авторизации и ограничения. Начать изучение можно с реализации аккаунта.

import "./account.constants"; import "./account.messages"; fun zeroAddress(): Address { return newAddress(0, 0); } struct PendingOutgoing { amount: Int as coins; to: Address;Исходный файл

message(0x0f8a7ea5) JettonTransfer { queryId: Int as uint64; amount: Int as coins; destination: Address; responseDestination: Address?; customPayload: Cell? = null; forwardTonAmount: Int as coins;Исходный файл

const ACCOUNT_CONTRACT_VERSION: Int = 0x00010001; const MIN_EMPTY_RECEIVE_TON: Int = ton("0.005"); const MIN_ADMIN_MSG_TON: Int = ton("0.015"); const MIN_JETTON_SEND_GAS: Int = ton("0.025"); const MAX_JETTON_SEND_GAS: Int = ton("0.15"); const MIN_ACCOUNT_TON_RESERVE: Int = ton("0.025"); const ACCOUNT_SEND_FEE_BUFFER: Int = ton("0.015");Исходный файл

import "./factory.messages"; import "./factory.constants"; import "./NexelorantAccountV1"; fun afZeroAddress(): Address { return newAddress(0, 0); } contract NexelorantAccountFactoryV1 { owner: Address;Исходный файл

message(0x8100) PauseAccountFactory {} message(0x8101) UnpauseAccountFactory {} message(0x8140) DeployNexelorantAccount { ownerWallet: Address; ownerPubKey: Int as uint256; salt: Int as uint64; }Исходный файл

const AF_ACTIVE: Int = 0; const AF_PAUSED: Int = 1; const AF_MIN_EMPTY_RECEIVE_TON: Int = ton("0.005"); const AF_MIN_ADMIN_MSG_TON: Int = ton("0.015"); const AF_DEPLOY_MIN_TON: Int = ton("0.075"); const AF_ACCOUNT_DEPLOY_TON: Int = ton("0.050"); const AF_MAX_TOTAL_DEPLOYED: Int = 1000000;Исходный файл

Affaire

CPP — уровень сделок

Affaire — martech-слой исполнения в экосистеме Nexelorant. В опубликованном наборе показана текущая реализация сделки CPP между рекламодателем и исполнителем: для неё разворачивается отдельный смарт-контракт с заданными при создании параметрами. distributorAddress — технический финансовый адрес Nexelorant для предусмотренной комиссионной части, а не третья бизнес-сторона сделки.

Параметры сделки задаются при развёртывании, а допустимые переходы состояния и расчёты определяются кодом контракта. Опубликованные исходники позволяют проверить эту логику и ограничения каждого обработчика.

import "./cppdeal.constants"; import "./cppdeal.messages"; fun cppZeroAddress(): Address { return newAddress(0, 0); } struct PendingCPPOutgoing { amount: Int as coins; to: Address;Исходный файл

const CPP_DEAL_CONTRACT_VERSION: Int = 0x00010001; const CPP_DEAL_STATUS_DEPLOYED: Int = 0; const CPP_DEAL_STATUS_CREATED: Int = 1; const CPP_DEAL_STATUS_FUNDED: Int = 2; const CPP_DEAL_STATUS_PUBLISHED: Int = 3; const CPP_DEAL_STATUS_ARBITRATION: Int = 4; const CPP_DEAL_STATUS_FINISHED: Int = 5; const CPP_DEAL_STATUS_CANCELLED: Int = 6; const CPP_DEAL_STATUS_OBJECTIVE_CANCELLED: Int = 7;Исходный файл

import "./factory.messages"; import "./factory.constants"; import "./CPPDealV1"; fun cppDfZeroAddress(): Address { return newAddress(0, 0); } contract CPPDealFactoryV1 { owner: Address;Исходный файл

message(0x9100) PauseCPPDealFactory {} message(0x9101) UnpauseCPPDealFactory {} message(0x9140) DeployCPPDeal { distributorAddress: Address; advertiserAddress: Address; performerAddress: Address; dealId: Int as uint64;Исходный файл

const CPP_DF_ACTIVE: Int = 0; const CPP_DF_PAUSED: Int = 1; const CPP_DF_MIN_EMPTY_RECEIVE_TON: Int = ton("0.005"); const CPP_DF_MIN_ADMIN_MSG_TON: Int = ton("0.015"); const CPP_DF_DEPLOY_MIN_TON: Int = ton("0.150"); const CPP_DF_DEAL_DEPLOY_TON: Int = ton("0.080"); const CPP_DF_MAX_TOTAL_DEPLOYED: Int = 1000000;Исходный файл

Сверяете с чем-то своим?

Если обнаружено расхождение, укажите файл, строку и ожидаемое поведение. При проверке развёрнутого экземпляра добавьте адрес контракта; при сравнении файлов — полученные контрольные суммы.

Спросить про файл Protocol Infrastructure

Nexelorant Account

NexelorantAccountV1.tact

account.messages.tact

account.constants.tact

NexelorantAccountFactoryV1.tact

factory.messages.tact

factory.constants.tact

CPP — уровень сделок

CPPDealV1.tact

cppdeal.messages.tact

cppdeal.constants.tact

CPPDealFactoryV1.tact

factory.messages.tact

factory.constants.tact