트랜잭션 명령어
모든 트랜잭션 명령어는 다음 패턴을 따릅니다:
qorechaind tx <module> <command> [args] [flags]
라이브 메인넷(체인 버전 v3.1.85)에 브로드캐스트하려면 --chain-id qorechain-vladi를, 테스트넷에는 --chain-id qorechain-diana를 설정하세요. 생략하면 클라이언트는 로컬 설정의 chain-id를 사용합니다.
공통 플래그는 모든 tx 하위 명령어에 적용됩니다:
| 플래그 | 타입 | 설명 |
|---|---|---|
--from | string | 서명 키의 이름 또는 주소 |
--chain-id | string | 체인 식별자 (기본값: 설정에서 가져옴) |
--fees | string | 트랜잭션 수수료 (예: 500uqor) |
--gas | string | 가스 한도 또는 추정을 위한 auto |
--gas-adjustment | float | auto 사용 시 가스 배수 (기본값: 1.0) |
--keyring-backend | string | 키링 백엔드: os, file, test |
--node | string | RPC 엔드포인트 (기본값: tcp://localhost:26657) |
--broadcast-mode | string | sync, async 또는 block |
-y | bool | 확인 프롬프트 건너뛰기 |
bank
send
한 계정에서 다른 계정으로 토큰을 전송합니다.
qorechaind tx bank send <from_address> <to_address> <amount> [flags]
staking
create-validator
네트워크에 새 검증인을 생성합니다.
qorechaind tx staking create-validator [flags]
| 플래그 | 타입 | 설명 |
|---|---|---|
--amount | string | 자기 위임 수량 (예: 1000000uqor) |
--pubkey | string | 검증인 합의 공개 키 (JSON) |
--moniker | string | 검증인 표시 이름 |
--commission-rate | string | 초기 수수료율 (예: 0.10) |
--commission-max-rate | string | 최대 수수료율 |
--commission-max-change-rate | string | 일일 최대 수수료 변경율 |
--min-self-delegation | string | 요구되는 최소 자기 위임량 |
edit-validator
기존 검증인의 설명 또는 수수료를 수정합니다.
qorechaind tx staking edit-validator [flags]
delegate
검증인에게 토큰을 위임합니다.
qorechaind tx staking delegate <validator_address> <amount> [flags]
redelegate
위임을 한 검증인에서 다른 검증인으로 이동합니다.
qorechaind tx staking redelegate <src_validator> <dst_validator> <amount> [flags]
unbond
검증인으로부터 토큰의 본딩을 해제합니다.
qorechaind tx staking unbond <validator_address> <amount> [flags]
distribution
withdraw-all-rewards
대기 중인 모든 스테이킹 보상을 인출합니다.
qorechaind tx distribution withdraw-all-rewards [flags]
withdraw-rewards
특정 검증인으로부터 보상을 인출합니다.
qorechaind tx distribution withdraw-rewards <validator_address> [flags]
| 플래그 | 타입 | 설명 |
|---|---|---|
--commission | bool | 검증인 수수료도 함께 인출 |
gov
submit-proposal
거버넌스 제안을 제출합니다.
qorechaind tx gov submit-proposal <proposal_file.json> [flags]
제안 파일은 제안 유형, 제목, 설명 및 실행할 메시지를 지정하는 JSON 문서입니다.
vote
활성 제안에 투표합니다.
qorechaind tx gov vote <proposal_id> <option> [flags]
투표 옵션: yes, no, abstain, no_with_veto.
deposit
제안에 보증금을 추가합니다.
qorechaind tx gov deposit <proposal_id> <amount> [flags]
pqc
Cosmos 트랜잭션 경로는 기본적으로 하이브리드 서명을 요구합니다(hybrid_signature_mode = required). gen-key 및 cosign 명령어는 클래식 secp256k1 서명과 함께 cosmos 경로에서 트랜잭션을 수행하는 데 필요한 Dilithium-5 (ML-DSA-87) 키와 PQCHybridSignature 확장을 생성합니다.
gen-key
하이브리드 서명을 위한 Dilithium-5 (ML-DSA-87) 포스트 양자 키를 생성합니다.
qorechaind tx pqc gen-key [flags]
cosign
트랜잭션에 Dilithium-5 공동 서명을 PQCHybridSignature 확장으로 첨부하여 하이브리드(secp256k1 + ML-DSA-87) 트랜잭션을 생성합니다. 기본 required 강제 모드에서 cosmos 경로 트랜잭션에 필수입니다. 표준 CosmJS / 릴레이어 도구는 트랜잭션을 수행하려면 이 확장을 생성해야 하며, QoreChain SDK의 buildHybridTx(includePqcPublicKey 포함)가 동일한 작업을 수행합니다.
qorechaind tx pqc cosign <unsigned_tx_file> [flags]
register-key
계정에 대한 포스트 양자 공개 키를 등록합니다.
qorechaind tx pqc register-key <algorithm> <pubkey_hex> [flags]
register-key-v2
확장 메타데이터 및 증명(attestation)과 함께 PQC 키를 등록합니다.
qorechaind tx pqc register-key-v2 <algorithm> <pubkey_hex> [flags]
| 플래그 | 타입 | 설명 |
|---|---|---|
--attestation | string | TEE 증명 데이터 (hex) |
--metadata | string | 추가 키 메타데이터 (JSON) |
migrate-key
기존 클래식 키를 하이브리드 PQC 키 쌍으로 마이그레이션합니다.
qorechaind tx pqc migrate-key <algorithm> <pqc_pubkey_hex> [flags]
recover-key
계정의 BIP-39 니모닉(stdin에서 읽음)으로부터 ML-DSA-87 키를 결정론적으로 재구성하여 로컬에 저장합니다(체인 버전 v3.1.85부터 사용 가능). 생태계 표준 파생 방식 SHAKE-256("qorechain:pqc:v1|address|mnemonic")을 사용합니다.
qorechaind tx pqc recover-key <name> <address> [flags]
| 플래그 | 타입 | 설명 |
|---|---|---|
--derivation | string | adapter(표준, 기본값) 또는 bridge(레거시 SHAKE-256(mnemonic)) |
rotate-key
계정의 ML-DSA-87 키를 동일한 알고리즘 내에서 교체합니다(체인 버전 v3.1.85부터 사용 가능). 예를 들어 레거시 방식으로 파생된 키를 표준 파생 방식으로 마이그레이션하거나 유출된 키를 폐기할 때 사용합니다. stdin에서 니모닉을 읽고, 이전 키와 새 키로 이중 서명한 뒤, 이전 키로 봉투(envelope)에 공동 서명하고 브로드캐스트합니다. stdout에는 트랜잭션 JSON만 출력하므로(안내 메시지는 stderr로 출력) -o json과 조합할 수 있습니다.
qorechaind tx pqc rotate-key [flags]
| 플래그 | 타입 | 설명 |
|---|---|---|
--old-derivation | string | 현재 등록된 키의 파생 방식 (adapter | bridge) |
--new-derivation | string | 새 키의 파생 방식 (adapter | bridge) |
--new-random | bool | 대신 새로운 무작위 키를 생성 |
xqore
lock
QOR 토큰을 xQORE 거버넌스 스테이킹 포지션에 잠급니다.
qorechaind tx xqore lock <amount> [flags]
| 플래그 | 타입 | 설명 |
|---|---|---|
--lock-duration | string | 잠금 기간 (예: 30d, 90d, 180d) |
unlock
xQORE를 다시 QOR로 잠금 해제합니다. 조기 잠금 해제는 페널티 등급에 따라 페널티가 발생할 수 있습니다.
qorechaind tx xqore unlock <amount> [flags]
bridge
deposit
외부 체인으로부터의 브리지 입금을 시작합니다.
qorechaind tx bridge deposit <chain_id> <amount> <asset> [flags]
| 플래그 | 타입 | 설명 |
|---|---|---|
--recipient | string | QoreChain에서의 수신자 주소 |
withdraw
외부 체인으로의 브리지 출금을 시작합니다.
qorechaind tx bridge withdraw <chain_id> <amount> <asset> <destination_address> [flags]
update-chain-config
단일 서명 트랜잭션으로 체인의 브리지를 활성화하거나 재구성합니다(체인 버전 v3.1.80부터 사용 가능). bridge_admin 키 또는 qcb_bridge 라이선스가 필요하며, 거버넌스 제안이나 체인 업그레이드는 필요하지 않습니다. 컨트랙트 주소, 확인(confirmation) 수, 아키텍처 및 상태를 설정합니다.
qorechaind tx bridge update-chain-config <chain_id> [flags] --from bridge-admin
set-verifier-bootstrap
체인의 활성 검증기(verifier)를 선택하고 해당 신뢰 루트를 설치합니다(역시 bridge_admin 권한 필요).
qorechaind tx bridge set-verifier-bootstrap <chain_id> <verifier> [flags] --from bridge-admin
crossvm
call
실행 환경(EVM, CosmWasm, SVM) 간에 크로스 VM 메시지를 전송합니다.
qorechaind tx crossvm call <target_vm> <contract_address> <payload_hex> [flags]
| 플래그 | 타입 | 설명 |
|---|---|---|
--source-vm | string | 소스 VM: evm, cosmwasm, svm |
--gas-limit | uint | 크로스 VM 실행을 위한 가스 한도 |
process-queue
대기 중인 크로스 VM 메시지를 수동으로 처리합니다(운영자 명령어).
qorechaind tx crossvm process-queue [flags]
svm
deploy-program
SVM 런타임에 BPF 프로그램을 배포합니다.
qorechaind tx svm deploy-program <program_binary_path> [flags]
| 플래그 | 타입 | 설명 |
|---|---|---|
--program-id | string | 선택적 프로그램 ID (base58) |
execute
배포된 SVM 프로그램에서 명령(instruction)을 실행합니다.
qorechaind tx svm execute <program_id> <instruction_data_hex> [flags]
| 플래그 | 타입 | 설명 |
|---|---|---|
--accounts | string | 명령에 사용할 계정 공개 키 목록 (쉼표로 구분) |
create-account
데이터 공간이 할당된 새 SVM 계정을 생성합니다.
qorechaind tx svm create-account <pubkey> <space> [flags]
| 플래그 | 타입 | 설명 |
|---|---|---|
--owner | string | 소유자 프로그램 (base58, 기본값: 시스템 프로그램) |
multilayer
register-sidechain
새 사이드체인 레이어를 등록합니다.
qorechaind tx multilayer register-sidechain <layer-id> <description> [flags]
| 플래그 | 타입 | 설명 |
|---|---|---|
--block-time-ms | uint | 목표 블록 시간(ms) (기본값 2000) |
--domains | string | 지원 도메인 목록, 쉼표로 구분 (기본값 defi) |
--max-tx | uint | 블록당 최대 트랜잭션 수 (기본값 1000) |
--min-validators | uint32 | 최소 검증인 집합 크기 (기본값 1) |
--settlement-interval | uint | 블록 단위 정산 간격 (기본값 100) |
--vm-types | string | 지원 VM 유형 목록, 쉼표로 구분 (기본값 evm) |
register-paychain
고빈도 마이크로트랜잭션을 위한 새 페이체인 레이어를 등록합니다.
qorechaind tx multilayer register-paychain <layer-id> <description> [flags]
| 플래그 | 타입 | 설명 |
|---|---|---|
--max-tx | uint | 블록당 최대 트랜잭션 수 (기본값 5000) |
--settlement-interval | uint | 블록 단위 정산 간격 (기본값 50) |
anchor-state
등록된 레이어에 대한 상태 앵커(정산)를 제출합니다.
qorechaind tx multilayer anchor-state <layer-id> <layer-height> <state-root-hex> <pqc-agg-sig-hex> [flags]
route-tx
트랜잭션을 최적의 레이어로 라우팅합니다.
qorechaind tx multilayer route-tx <tx_data_hex> [flags]
| 플래그 | 타입 | 설명 |
|---|---|---|
--target-layer | string | 특정 레이어로 강제 라우팅 |
update-layer-status
레이어의 운영 상태를 업데이트합니다(운영자 전용).
qorechaind tx multilayer update-layer-status <layer_id> <status> [flags]
상태 값: active, paused, draining.
challenge-anchor
상태 앵커에 대한 사기 이의 제기(fraud challenge)를 제출합니다.
qorechaind tx multilayer challenge-anchor <layer_id> <anchor_hash> <proof_hex> [flags]
rdk
create-rollup
Rollup Development Kit에 새 롤업을 등록합니다.
qorechaind tx rdk create-rollup <rollup_id> [flags]
| 플래그 | 타입 | 설명 |
|---|---|---|
--settlement-type | string | optimistic, zk, pessimistic, sovereign |
--profile | string | 프리셋: defi, gaming, nft, enterprise, custom |
--stake | string | 운영자 스테이크 수량 |
--da-enabled | bool | 네이티브 데이터 가용성 활성화 |
submit-batch
롤업에 대한 정산 배치를 제출합니다.
qorechaind tx rdk submit-batch <rollup_id> <state_root_hex> <batch_data_path> [flags]
challenge-batch
정산 배치에 대한 사기 이의 제기를 제출합니다(옵티미스틱 롤업).
qorechaind tx rdk challenge-batch <rollup_id> <batch_index> <proof_hex> [flags]
finalize-batch
이의 제기 기간이 지난 배치를 수동으로 확정합니다.
qorechaind tx rdk finalize-batch <rollup_id> <batch_index> [flags]
pause-rollup
롤업을 일시 중지합니다(운영자 전용).
qorechaind tx rdk pause-rollup <rollup_id> [flags]
resume-rollup
일시 중지된 롤업을 재개합니다(운영자 전용).
qorechaind tx rdk resume-rollup <rollup_id> [flags]
stop-rollup
롤업을 영구적으로 중지하고 스테이크를 해제합니다(운영자 전용).
qorechaind tx rdk stop-rollup <rollup_id> [flags]
롤업 출금 및 크로스 레이어 정산도 rdk 트랜잭션 그룹 아래에 노출됩니다(예: 확정된 배치에 대해 증명된 출금을 정산하는 execute-withdrawal 명령어). 정확한 인자와 플래그는 롤업의 정산 유형과 DA 구성에 따라 달라지므로, 이러한 트랜잭션을 구성하기 전에 권위 있는 명령어 목록은 Rollup Development Kit 문서를 참조하세요.
babylon
submit-btc-checkpoint
에포크에 대한 BTC 체크포인트를 제출합니다.
qorechaind tx babylon submit-btc-checkpoint <epoch> <checkpoint_hex> [flags]
btc-restake
Babylon 통합을 통해 BTC를 리스테이킹합니다.
qorechaind tx babylon btc-restake <amount> [flags]
| 플래그 | 타입 | 설명 |
|---|---|---|
--btc-tx-hash | string | 증거로 사용할 Bitcoin 트랜잭션 해시 |
abstractaccount
create
프로그래밍 가능한 지출 규칙이 있는 추상 계정을 생성합니다.
qorechaind tx abstractaccount create [flags]
| 플래그 | 타입 | 설명 |
|---|---|---|
--spending-rules | string | 지출 규칙을 정의하는 JSON 파일 |
update-spending-rules
기존 추상 계정의 지출 규칙을 업데이트합니다.
qorechaind tx abstractaccount update-spending-rules <rules_file.json> [flags]
execute-cosmos
정식(canonical) 계정으로부터 인증자(authenticator)가 승인한 Native 레인 bank send를 릴레이합니다(체인 버전 v3.1.85부터 사용 가능). 릴레이어(--from)가 봉투(envelope)에 서명하고 비용을 지불하며, 재사용 방지(replay-bound) 서명 바이트에 대한 연결된 키의 서명이 승인 역할을 합니다. Linked Wallet Authenticators를 참조하세요.
qorechaind tx abstractaccount execute-cosmos <account> <to> <amount> \
<auth_pubkey_hex> <auth_signature_hex> <nonce> --from relayer -y
execute-evm
정식 계정의 EVM 주소로부터 인증자가 승인한 EVM 호출 또는 전송을 릴레이합니다(체인 버전 v3.1.85부터 사용 가능). 논스는 계정의 현재 EVM 논스입니다.
qorechaind tx abstractaccount execute-evm <account> <to> <value> <data_hex> \
<auth_pubkey_hex> <auth_signature_hex> <nonce> --from relayer -y
rlconsensus
PRISM은 합의 매개변수를 조정하는 강화 학습 레이어입니다. 이 명령어들은 PRISM 에이전트를 제어하며, CLI 모듈 이름 rlconsensus와 그 하위 명령어는 그대로 유지됩니다.
set-agent-mode
PRISM 에이전트의 운영 모드를 설정합니다(거버넌스 전용).
qorechaind tx rlconsensus set-agent-mode <mode> [flags]
모드 값: 0 (끄기), 1 (관찰), 2 (제안), 3 (자동).
resume-agent
서킷 브레이커 발동 후 PRISM 에이전트를 재개합니다.
qorechaind tx rlconsensus resume-agent [flags]
update-policy
PRISM 에이전트 정책 구성을 업데이트합니다(거버넌스 전용).
qorechaind tx rlconsensus update-policy <policy_file.json> [flags]
update-reward-weights
PRISM 에이전트의 보상 가중치 구성을 업데이트합니다.
qorechaind tx rlconsensus update-reward-weights [flags]
| 플래그 | 타입 | 설명 |
|---|---|---|
--throughput-weight | string | 처리량 보상 가중치 |
--latency-weight | string | 지연 시간 보상 가중치 |
--security-weight | string | 보안 보상 가중치 |