SVM Actions

Эти действия доступны при использовании дополнения SVM для построения, подписания и отправки транзакций.

deploy_program

svm::deploy_program развёртывает программу Solana в указанной SVM-совместимой сети.

Входные параметры

Выходные параметры

action "deploy" "svm::deploy_program" {
    description = "Deploy hello world program"
    program = svm::get_program_from_anchor_project("hello_world")
    authority = signer.authority
    payer = signer.payer  # Optional, defaults to authority
}

process_instructions

Действие svm::process_instructions кодирует инструкции, добавляет их в транзакцию, а затем подписывает и отправляет транзакцию.

Входные параметры

Выходные данные

action "program_call" "svm::process_instructions" {
    description = "Invoke instructions"
    instruction {
        program_idl = variable.program.idl
        instruction_name = "initialize"
        instruction_args = [1]
        payer {
            public_key = signer.payer.public_key
        }
    }
    signers = [signer.caller]
}

send_sol

Действие svm::send_sol кодирует транзакцию, которая отправляет SOL, подписывает её и транслирует в сеть.

Входные данные

Выходные данные

action "send_sol" "svm::send_sol" {
    description = "Send some SOL"
    amount = svm::sol_to_lamports(1)
    signer = signer.caller
    recipient = "zbBjhHwuqyKMmz8ber5oUtJJ3ZV4B6ePmANfGyKzVGV"
}

send_token

Действие svm::send_token кодирует транзакцию, которая отправляет указанный токен, подписывает её и транслирует в сеть.

Входные данные

Выходные данные

action "send_sol" "svm::send_token" {
    description = "Send some tokens"
    amount = 1000000
    signers = [signer.caller]
    recipient = "zbBjhHwuqyKMmz8ber5oUtJJ3ZV4B6ePmANfGyKzVGV"
    token = "3bv3j4GvMPjvvBX9QdoX27pVoWhDSXpwKZipFF1QiVr6"
    fund_recipient = true
}

setup_surfnet

svm::setup_surfnet можно использовать для настройки surfnet.

Поддерживаются следующие операции:

• set_account — Задать поля lamports, owner, data и executable для аккаунта
• set_token_account — Задать сумму, делегата, делегированную сумму и authority закрытия для token account
• clone_program_account — Клонировать program account из исходного program ID в целевой program ID
• set_program_authority — Задать authority программы
• deploy_program — Развернуть программу непосредственно на surfnet (через прямую запись в аккаунт, без транзакций)
• reset_account — Сбросить аккаунт, удалив его из локального кэша для повторного получения из вышестоящего узла
• stream_account — Транслировать данные аккаунта из мейннета, чтобы локальные данные всегда соответствовали мейннету

Входные данные

set_account

Устанавливает данные аккаунта непосредственно на surfnet.

Необходимо указать хотя бы один из следующих параметров: lamports, data, owner, executable или rent_epoch (если не используется account_path).

set_token_account

Устанавливает данные token account в surfnet. Associated token account автоматически определяется на основе публичного ключа владельца и token mint.

Необходимо указать хотя бы один из следующих параметров: amount, delegate, state, delegated_amount или close_authority.

clone_program_account

Клонирует program account из одного ID программы в другой в surfnet.

set_program_authority

Устанавливает или удаляет полномочия на обновление программы в surfnet.

deploy_program

Развёртывает программу непосредственно в surfnet через запись данных аккаунта (не через транзакции).

reset_account

Сбрасывает аккаунт в surfnet, удаляя его из локального кэша, чтобы он был повторно получен из вышестоящей сети.

stream_account

Передаёт данные аккаунта с основного RPC URL в surfnet, поддерживая локальные данные аккаунта в синхронизации с основной сетью.

action "setup" "svm::setup_surfnet" {
    // Set account balance
    set_account {
        public_key = signer.caller.public_key
        lamports = 999999999
    }

    // Set token balance
    set_token_account {
        public_key = signer.caller.public_key
        token = "usdc"
        amount = 1000000
    }

    // Clone a program
    clone_program_account {
        source_program_id = "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
        destination_program_id = variable.my_program_id
    }

    // Set program authority
    set_program_authority {
        program_id = variable.my_program_id
        authority = signer.caller.public_key
    }

    // Deploy a program directly
    deploy_program {
        program_id = variable.my_program_id
        binary_path = "./target/deploy/my_program.so"
        idl_path = "./target/idl/my_program.json"
    }

    // Reset an account to re-fetch from upstream
    reset_account {
        public_key = variable.some_pubkey
    }

    // Stream account data from mainnet
    stream_account {
        public_key = variable.some_pubkey
        include_owned_accounts = true
    }
}