Skip to main content

Konfigurasi Noda Stacks

Pemakaian

stacks-node sub-command [--subcommand-option <value>]

Subperintah

The stacks-node binary may have deprecated commands that are not documented on this page. Perintah yang tidak digunakan lagi mungkin dapat diakses hingga sepenuhnya dihapus dari sumbernya. :::

mocknet

Memulai noda berdasarkan penyiapan lokal cepat yang meniru burnchain. Ideal untuk pengembangan kontrak pintar.

Contoh:

stacks-node mocknet

krypton

Start a node that will join and stream blocks from the public krypton regtest, powered by Blockstack via Proof of Transfer.

Contoh:

stacks-node krypton

testnet

Start a node that will join and stream blocks from the public testnet.

Contoh:

stacks-node testnet

mainnet

Memulai noda yang bergabung dan mengalirkan blok dari mainnet publik.

Contoh:

stacks-node mainnet

mulai

Memulai noda dengan konfigurasi Anda sendiri. Can be used for joining a network, starting a new chain, or replacing default values used by the mocknet or testnet subcommands.

Argumen

--config: jalur relatif atau absolut ke file konfigurasi TOML. Diperlukan.

Contoh:

stacks-node start --config=/path/to/config.toml

Lihat Opsi File Konfigurasi untuk informasi lebih lanjut.

versi

Menampilkan informasi tentang versi saat ini dan siklus rilis.

Contoh:

stacks-node version

bantuan

Menampilkan pesan bantuan.

Contoh:

stacks-node help

Opsi File Konfigurasi

File konfigurasi TOML memiliki beberapa bagian di mana opsi dapat ditempatkan.

Untuk melihat daftar contoh konfigurasi, lihat halaman ini .

Bagian: noda

Berisi berbagai opsi konfigurasi yang berkaitan dengan noda-stacks.

Contoh:

[node]
rpc_bind = "0.0.0.0:20443"
p2p_bind = "0.0.0.0:20444"
# Enter your private key here
seed = "replace-with-your-private-key"
miner = true

working_dir (opsional)

Jalur absolut ke direktori yang akan digunakan noda-stacks untuk menyimpan berbagai data.

Contoh:

working_dir = "/root/stacks-node"

rpc_bind

Alamat dan port noda-stacks harus diikat untuk koneksi RPC.

Contoh:

rpc_bind = "0.0.0.0:20443"

p2p_bind

Alamat dan port noda-stacks harus diikat untuk koneksi RPC.

Contoh:

p2p_bind = "0.0.0.0:20444"

data_url (opsional)

Alamat dan port dari mana noda-stacks akan menerima koneksi rpc yang masuk.

Contoh:

data_url = "1.2.3.4:20443"

p2p_address (opsional)

Alamat dan port dari mana noda-stacks akan menerima koneksi p2p yang masuk.

Contoh:

p2p_address = "1.2.3.4:20444"

bootstrap_node (opsional)

Kunci publik, alamat, dan noda-stacks port harus digunakan untuk menarik data transaksi dari saat memulai.

Contoh:

bootstrap_node = "047435c194e9b01b3d7f7a2802d6684a3af68d05bbf4ec8f17021980d777691f1d51651f7f1d566532c804da506c117bbf79ad62eea81213ba58f8808b4d9504ad@testnet.blockstack.org:20444"

wait_time_for_microblocks (opsional)

Jumlah waktu (dalam milidetik) yang akan ditunggu oleh sebuah noda sebelum mencoba menambang sebuah blok, setelah mengejar ujung rantai yang ditautkan. Ini dapat memberi waktu untuk menyiarkan mikroblok yang akan disertakan dalam blok yang ditambang tersebut.

Contoh:

wait_time_for_microblocks = 15000

seed (opsional)

Kunci privat yang digunakan untuk menambang. Hanya diperlukan jika miner disetel ke true.

Contoh:

seed = "replace-with-your-private-key"

local_peer_seed (opsional)

Kunci privat yang digunakan untuk menandatangani pesan P2P di jaringan Stacks. Ini membedakan peer jaringan dan digunakan bahkan oleh noda non-penambangan.

Contoh:

local_peer_seed = "replace-with-your-private-key"

miner (opsional)

Menentukan apakah noda-stacks menjalankan pengikut (false) atau penambang (true). Default ke false jika dihilangkan.

Contoh:

miner = true

mine_microblocks (opsional)

Menentukan apakah noda-stacks akan menambang mikroblok. Hanya akan berlaku jika miner disetel ke true.

Contoh:

mine_microblocks = true

prometheus_bind (opsional)

Alamat dan port noda-stacks harus terbuka untuk pengumpulan metrik Prometheus.

Contoh:

prometheus_bind = "0.0.0.0:9153"

Bagian: events_observer (opsional)

Berisi opsi untuk menonton event yang dipancarkan oleh layanan stacks-blockchain-api lokal.

This section can be repeated multiple times. :::

Contoh:

[[events_observer]]
endpoint = "address-to-my-local.stacks-node-api.com:3700"
retry_count = 255
events_keys = ["*"]

endpoint

Alamat dan port ke api-noda-stacks untuk menonton event.

Contoh:

endpoint = "address-to-my-local.stacks-node-api.com:3700"

retry_count

Frekuensi pengiriman ulang event ke endpoint sebelum gagal.

Contoh:

retry_count = 255

events_keys

Kunci event yang harus ditonton. Event noda yang dipancarkan dapat dibatasi oleh akun, nama fungsi, dan jenis peristiwa. Asterix ("*") dapat digunakan untuk memancarkan semua event.

Contoh:

events_keys = ["*"]
events_keys = [
"STGT7GSMZG7EA0TS6MVSKT5JC1DCDFGZWJJZXN8A.store::print",
"STGT7GSMZG7EA0TS6MVSKT5JC1DCDFGZWJJZXN8A.contract.ft-token",
"STGT7GSMZG7EA0TS6MVSKT5JC1DCDFGZWJJZXN8A.contract.nft-token",
"stx"
]

Bagian: connection_options (opsional)

Menentukan opsi konfigurasi untuk orang lain yang terhubung ke noda stacks.

Contoh:

[connection_options]
public_ip_address = "1.2.3.4:20444"
download_interval = 60
walk_interval = 30

public_ip_address

IP publik yang diiklankan dari noda-stacks ini.

Contoh:

public_ip_address = "1.2.3.4:20444"

download_interval

Waktu (dalam detik) antara upaya mengunduh blok.

Contoh:

download_interval = 60

walk_interval

Waktu (dalam detik) antara upaya untuk berjalan di sekitar lingkungan.

Contoh:

walk_interval = 30

read_only_call_limit_read_length

Jumlah total byte yang diizinkan untuk dibaca oleh panggilan fungsi read-only individual.

Contoh:

read_only_call_limit_read_length = 100000

read_only_call_limit_read_count

Jumlah total operasi baca independen yang diizinkan untuk panggilan fungsi read-only individual.

Contoh:

read_only_call_limit_read_count = 30

read_only_call_limit_runtime

Batas Biaya runtime untuk panggilan fungsi read-only individual.

Contoh:

read_only_call_limit_runtime = 1000000000

Bagian: burnchain

Bagian ini berisi opsi konfigurasi yang berkaitan dengan blockchain yang diikat oleh noda-stacks di backend untuk proof-of-transfer (BTC).

Contoh:

[burnchain]
chain = "bitcoin"
mode = "mainnet"
peer_host = "your.bitcoind.node.org"
rpc_port = 8332
peer_port = 8333

chain

Noda-stacks blockchain mengikat pada backend untuk proof-of-transfer. Hanya nilai yang didukung: "bitcoin".

Contoh:

chain = "bitcoin"

mode

Profil atau fase pengujian untuk menjalankan noda-stacks. Nilai yang valid adalah "mocknet", "helium", "neon", "argon", "krypton", "xenon".

Contoh:

mode = "xenon"

peer_host

Nama domain host yang menjalankan blockchain Bitcoin backend. Diperlukan untuk menjalankan noda Bitcoin pribadi secara lokal, atau menggunakan noda Bitcoin yang dihosting secara publik.

Contoh:

peer_host = "your.bitcoind.node.org"

rpc_port

port peer_host noda-stacks akan terhubung untuk koneksi RPC.

Contoh:

rpc_port = 8332

peer_port

port peer_host noda-stacks akan terhubung untuk koneksi P2P.

Contoh:

peer_port = 8333

burn_fee_cap (opsional)

Jumlah maksimum (dalam Satoshi) dari "komitmen bakar" untuk disiarkan untuk pemilihan blok berikutnya.

Contoh:

burn_fee_cap = 30000

satoshis_per_byte (opsional)

Jumlah (dalam Satoshi) per byte virtual. Ini digunakan untuk menghitung biaya transaksi.

Contoh:

satoshis_per_byte = 50

Jadi total biaya transaksi adalah (estimated_tx_size * satoshis_per_byte) + burn_fee_cap.

commit_anchor_block_within (opsional)

Menetapkan periode waktu (dalam milidetik) untuk komitmen. Hanya digunakan bila mode disetel ke "helium".

Contoh:

commit_anchor_block_within = 10000

Bagian: ustx_balance (hanya testnet/regtest)

Bagian ini berisi opsi konfigurasi yang berkaitan dengan alokasi blok genesis untuk alamat di mikro-STX. Jika pengguna mengubah nilai-nilai ini, noda mereka mungkin bertentangan dengan noda lain di jaringan dan tidak dapat menyinkronkan dengan noda lain.

info

This section can repeat multiple times, and thus is in double-brackets. Setiap bagian hanya dapat mendefinisikan satu alamat. Bagian ini diabaikan jika menjalankan noda di mainnet.

Contoh:

[[ustx_balance]]
address = "STB44HYPYAT2BB2QE513NSP81HTMYWBJP02HPGK6"
amount = 10000000000000000

[[ustx_balance]]
address = "ST11NJTTKGVT6D1HY4NJRVQWMQM7TVAR091EJ8P2Y"
amount = 10000000000000000

[[ustx_balance]]
address = "ST1HB1T8WRNBYB0Y3T7WXZS38NKKPTBR3EG9EPJKR"
amount = 10000000000000000

[[ustx_balance]]
address = "STRYYQQ9M8KAF4NS7WNZQYY59X93XEKR31JP64CP"
amount = 10000000000000000

address

Alamat yang menjaga saldo mikro-STX.

Contoh:

address = "STB44HYPYAT2BB2QE513NSP81HTMYWBJP02HPGK6"

amount

Saldo micro-STX diberikan ke alamat di awal noda.

Contoh:

amount = 10000000000000000