Деплой смарт-контрактів у Polkadot/Kusama на ink! з аудитом

Ми — команда блокчейн-інженерів з 7-річним досвідом у Web3. За останні три роки ми розгорнули понад 15 смарт-контрактів у parachain Astar та Kusama. Коли клієнт приходить з задачею перенести свій DeFi-протокол з Ethereum у Polkadot, перше, що ми пояснюємо: Polkadot — це не ще один L2. Тут немає єдиної VM для всіх мереж. Смарт-контракти деплояться не в Relay Chain, а в парачейни з включеним модулем pallet-contracts. Kusama — це канаркова мережа Polkadot з більш швидким governance та менш суворими вимогами до слотів. Для тестування production-логіки ми використовуємо Kusama, для фінального деплою — Polkadot або спеціалізований парачейн (Astar, Phala, Aleph Zero).

Нещодавно ми розгорнули vault-контракт для стейкінгу на Astar. Клієнт заощадив 40% на gas порівняно з EVM-версією — ink! контракти в середньому в 1.8 рази ефективніші за газом, ніж аналогічні Solidity на Moonbeam. Це досягається за рахунок компіляції в Wasm та більш точної моделі газу WeightV2.

Чому ink! а не Solidity для Polkadot?

Контракти для pallet-contracts пишуться на ink! — це нативний Rust з макросами, які генерують метадані контракту та ABI-сумісний інтерфейс. На відміну від Solidity, ink! дає прямий доступ до низькорівневих оптимізацій Rust і компілюється в Wasm.

#[ink::contract]
mod vault {
    use ink::storage::Mapping;

    #[ink(storage)]
    pub struct Vault {
        balances: Mapping<AccountId, Balance>,
        owner: AccountId,
    }

    impl Vault {
        #[ink(constructor)]
        pub fn new() -> Self {
            Self {
                balances: Mapping::default(),
                owner: Self::env().caller(),
            }
        }

        #[ink(message, payable)]
        pub fn deposit(&mut self) {
            let caller = self.env().caller();
            let value = self.env().transferred_value();
            let current = self.balances.get(caller).unwrap_or(0);
            self.balances.insert(caller, &(current + value));
        }

        #[ink(message)]
        pub fn withdraw(&mut self, amount: Balance) -> Result<(), Error> {
            let caller = self.env().caller();
            let balance = self.balances.get(caller).unwrap_or(0);
            if balance < amount {
                return Err(Error::InsufficientBalance);
            }
            self.balances.insert(caller, &(balance - amount));
            self.env().transfer(caller, amount)
                .map_err(|_| Error::TransferFailed)
        }
    }
}

Кілька ключових відмінностей від Solidity, які ламають інтуїцію EVM-розробника:

• Немає msg.value у звичайних функціях — тільки в #[ink(message, payable)]. Виклик payable-функції без прапорця поверне помилку.
• Storage через Mapping без ітерації — немає mapping.keys(). Якщо потрібні списки — зберігайте окремо Vec<AccountId>.
• AccountId замість address — 32 байти, не 20. Адреси у форматі SS58, не hex.
• Balance це u128, не uint256. Але практично різниці немає.

Як вибрати парачейн для деплою?

Не всі парачейни Polkadot підтримують смарт-контракти безпосередньо. Для ink! контрактів потрібні парачейни з включеним pallet-contracts. Нижче — порівняння популярних варіантів:

Для production-деплою ми рекомендуємо Astar — він найбільш зрілий, має підтримку як Wasm, так і EVM, та багату інфраструктуру.

Інструментарій: cargo-contract

cargo install cargo-contract --force
cargo contract new my_contract
cd my_contract
# Збірка: генерує .contract, .wasm, .json (ABI)
cargo contract build --release
# Запуск тестів
cargo test

Файл .contract — це архів з WASM bytecode та метаданими. Саме його деплоїмо.

Середовища деплою та тестування

Локальне тестування: substrate-contracts-node

substrate-contracts-node --dev --tmp 

Запускає однонодову мережу з попередньо фінансованими акаунтами (Alice, Bob, Charlie — як Hardhat accounts[0]). Contracts UI на contracts-ui.substrate.io або programmatic через @polkadot/api.

Тестнет: Contracts on Rococo

Rococo — тестнет Polkadot з парачейном contracts спеціально для тестування ink!. Faucet: paritytech.github.io/polkadot-testnet-faucet.

Production: Astar Network

Astar — найбільш зрілий парачейн з pallet-contracts у Polkadot ecosystem. Підтримує і ink! (Wasm), і EVM (Solidity) контракти в одній мережі, cross-VM виклики через XVM. Для більшості production use cases на Polkadot — деплоїмо на Astar.

Деплой через polkadot.js

import { ApiPromise, WsProvider, Keyring } from '@polkadot/api';
import { CodePromise } from '@polkadot/api-contract';
import * as fs from 'fs';

async function deploy() {
    const provider = new WsProvider('wss://rpc.astar.network');
    const api = await ApiPromise.create({ provider });
    const keyring = new Keyring({ type: 'sr25519' });
    const deployer = keyring.addFromUri(process.env.MNEMONIC!);
    const wasm = fs.readFileSync('./target/ink/vault.wasm');
    const abi = JSON.parse(fs.readFileSync('./target/ink/vault.json', 'utf8'));
    const code = new CodePromise(api, abi, wasm);
    const gasLimit = api.registry.createType('WeightV2', {
        refTime: 30_000_000_000n,
        proofSize: 1_000_000n,
    });
    const storageDepositLimit = null; // автоматично
    const tx = code.tx.new({ gasLimit, storageDepositLimit });
    await new Promise<void>((resolve, reject) => {
        tx.signAndSend(deployer, ({ contract, status }) => {
            if (status.isInBlock) {
                console.log('Contract address:', contract?.address.toString());
                resolve();
            }
        }).catch(reject);
    });
    await api.disconnect();
}

Модель газу: WeightV2

На відміну від EVM де gas — одне число, Substrate використовує двовимірний weight:

• refTime — час обчислень (пікосекунди)
• proofSize — розмір storage proof для light clients

При деплої потрібно оцінити обидва параметри. Спосіб: сухий прогін (contracts.instantiate з estimateGas: true) або використовуємо cargo-contract:

cargo contract instantiate --dry-run \ --constructor new \ --args \ --suri //Alice \ --url ws://127.0.0.1:9944 

Storage deposit

pallet-contracts вимагає депозит за зайнятий storage — аналог EIP-1153 transient storage, але постійний. Вартість пропорційна байтам у storage контракту. При видаленні storage (через ink::env::set_contract_storage::<K, ()>(&key, &())) депозит повертається. Це важливо для long-lived контрактів з великим state. На практиці storage deposit для типового контракту становить 0.1–0.5% від вартості деплою, що значно нижче, ніж на EVM-парачейнах.

Типові помилки при міграції з EVM

Cross-contract виклики в ink! вимагають імпорту ABI викликаного контракту та явного вказання gas ліміту — немає автоматичного forwarding як в Solidity {gas: gasleft()}.

Етапи деплою

1. Аналіз вимог — вивчаємо логіку контракту, вибираємо парачейн.
2. Написання контракту — реалізація на ink! з урахуванням безпеки та оптимізації газу.
3. Тестування — локальне (substrate-contracts-node) та на Rococo.
4. Аудит безпеки — зв'язка Slither для ink! та ручний аудит.
5. Деплой у production — розгортання в Astar або іншому парачейні.
6. Підтримка — моніторинг, оновлення, допомога користувачам.

Що входить у роботу

• Повний цикл від ідеї до деплою.
• Вихідний код з детальними коментарями.
• Документація по контракту (white paper, технічна специфікація).
• Тестовий звіт (результати unit-тестів та фаззингу).
• Доступи до контракту та інструкція по взаємодії.
• Місяць технічної підтримки після деплою.