Stacks Raw Tx Breakdown

import {bytesToHex, hexToBytes, intToBigInt, intToBytes} from '@stacks/common';
import {StacksTestnet, StacksMainnet} from "@stacks/network";
import {
    AddressHashMode, AddressVersion, AnchorMode, AuthType, createMemoString, createSingleSigSpendingCondition,
    createStacksPrivateKey, estimateTransactionFeeWithFallback, getNonce, getPublicKey, PayloadType,
    principalCV, publicKeyToString, signWithKey, StacksMessageType, StacksTransaction, TransactionVersion,
    broadcastTransaction, makeSTXTokenTransfer
} from "@stacks/transactions";
import {c32address} from "c32check";
import {sha512_256} from "@noble/hashes/sha512";
import {writeFile} from 'node:fs';

// 没有必要自己实现 buildTx 函数，因为 stacks.js 中已经有了 makeSTXTokenTransfer 可以转帐 STX
// 这里仅仅是为了演示交易的具体构造过程才自己实现
async function buildTx(network, senderKey, recipient, amount, memo) {
    const publicKey = publicKeyToString(getPublicKey(createStacksPrivateKey(senderKey)))
    console.log("publicKey", publicKey)  // 03a1328ef6068af52aea4c09f1a31627017acd2ea15a3e23df2760ff1457f77165

    const spendingCondition = createSingleSigSpendingCondition(
        AddressHashMode.SerializeP2PKH,
        publicKey,
        0,
        0
    );

    const authorization = {
        authType: AuthType.Standard,
        spendingCondition
    };

    const payload = {
        type: StacksMessageType.Payload,
        payloadType: PayloadType.TokenTransfer,
        recipient: principalCV(recipient),
        amount: intToBigInt(amount, false),
        memo: createMemoString(memo),
    };

    const transaction = new StacksTransaction(
        network.version,
        authorization,
        payload,
        undefined, // no post conditions on STX transfers (see SIP-005)
        undefined, // no post conditions on STX transfers (see SIP-005)
        AnchorMode.Any,
        network.chainId
    );

    // Estimate the fee
    // const fee = await estimateTransactionFeeWithFallback(transaction, network);
    const fee = 2233;  // 应该使用上一行代码从链上获得，这里为了演示方便直接写死
    transaction.setFee(fee);

    // Set the nonce
    const addressVersion = network.version === TransactionVersion.Mainnet ? AddressVersion.MainnetSingleSig : AddressVersion.TestnetSingleSig;
    const senderAddress = c32address(addressVersion, spendingCondition.signer);
    console.log("senderAddress", senderAddress);   // ST24MG3M188B0RGND0PTTXA9RHAYBMNQ53GE6WRQA
    // const nonce = await getNonce(senderAddress, network);
    const nonce = 1;  // 应该使用上一行代码从链上获得，这里为了演示方便直接写死
    transaction.setNonce(nonce);

    // Sign the transaction, set the signature on the spending condition
    const privateKey = createStacksPrivateKey(senderKey);
    const msg =
        transaction.signBegin() +
        bytesToHex(new Uint8Array([transaction.auth.authType])) +
        bytesToHex(intToBytes(fee, false, 8)) +
        bytesToHex(intToBytes(nonce, false, 8));
    console.log("msg", msg);  // 855f926c9893082213fd2d8bdd100dbbe98422b918959579a29a09dc290d6dec0400000000000008b90000000000000001
    const msgHash = sha512_256(hexToBytes(msg));
    console.log("msgHash", bytesToHex(msgHash))  // 05733e861a2a10b4b389dd9b9cb82a348ebd442e7015f19026efa0e2d48db5ab
    const signature = signWithKey(privateKey, bytesToHex(msgHash)); // VRS signature
    console.log("signature", signature.data);  // 00fac7b6f6a97d511d89d72e1fa496621c6d95ee77d212a057a23669adc76ff25d69f93d90c57d16c3608f7a603f3f55880ddb25603472ca8476f2cc98aaccb6da
    transaction.auth.spendingCondition.signature = signature;

    return transaction
}

// 构造 tx
const tx = await buildTx(
    new StacksTestnet(),  // 如果是主网交易，则改为 StacksMainnet()
    '53e804fec042f8fa21c6ab9e8c00d2c879aed9c8737601a8888602848471869a01', // 发送方私钥（注：最后多一个字节 01 表示使用对应 compressed 公钥推导发送方地址）
    'STN3035BW0HRKFJE3E4NHN2867TZN63N9XCGSM1Z', // 接收方地址
    123, // 单位为 micro-STX
    'test memo')

const rawTx = tx.serialize();
console.log("txHex", bytesToHex(rawTx)) // 8080000000040089480e8142160c42ad05b5aea9388abcba56e51c000000000000000100000000000008b90000fac7b6f6a97d511d89d72e1fa496621c6d95ee77d212a057a23669adc76ff25d69f93d90c57d16c3608f7a603f3f55880ddb25603472ca8476f2cc98aaccb6da03020000000000051a2a300cabe02389be4e1b8958d44831f5fa98754f000000000000007b74657374206d656d6f00000000000000000000000000000000000000000000000000
console.log("txId", bytesToHex(sha512_256(rawTx)));  // 605c958a9ddcf38ac36f0f6f44c02d3d3cf5602ef3d3ad517e4756bc2d1c0883

writeFile('raw_tx.bin', rawTx, (err) => {
    if (err) throw err;
    console.log('The raw tx has been saved!');
});

#!/usr/bin/env python3

import hashlib
import ecdsa                      # pip install ecdsa
from Crypto.Hash import SHA512    # pip install pycryptodome


# SHA512/256（https://eprint.iacr.org/2010/548.pdf ）是 SHA512 的截断版本，截断后的哈希值长度为 256 位
class SHA512_256(SHA512.SHA512Hash):
    def __init__(self, data=None):
        super().__init__(data, truncate='256')


priv_key_hex = '53e804fec042f8fa21c6ab9e8c00d2c879aed9c8737601a8888602848471869a'
priv_key = int(priv_key_hex, 16)

msg = bytes.fromhex('855f926c9893082213fd2d8bdd100dbbe98422b918959579a29a09dc290d6dec0400000000000008b90000000000000001')  # 前面有介绍它是怎么计算的
msgHash = SHA512_256(msg).digest()                # Stacks 区块链要求待签名消息的哈希值必须是 SHA512/256 的结果
print("msgHash:                ", msgHash.hex())  # 05733e861a2a10b4b389dd9b9cb82a348ebd442e7015f19026efa0e2d48db5ab

sk: ecdsa.SigningKey = ecdsa.SigningKey.from_secret_exponent(priv_key, curve=ecdsa.SECP256k1)
# 下面生成确定性签名（RFC6979），设置计算 k 时所用的 HMAC 中的哈希函数为 sha256
# 当然我们设置计算 k 时所用的 HMAC 中的哈希函数和对 msg 采用的哈希函数一致（即也设置为 SHA512_256）也可以正常产生签名
# 这里之所以采用 sha256，是为了和 stacks.js 中的 makeSTXTokenTransfer 的设置一样
deterministic_signature: bytes = sk.sign_digest_deterministic(msgHash, hashfunc=hashlib.sha256)

r = deterministic_signature.hex()[0:64]
s = deterministic_signature.hex()[64:]
print("RFC6979 signature (r):  ", r)  # fac7b6f6a97d511d89d72e1fa496621c6d95ee77d212a057a23669adc76ff25d
print("RFC6979 signature (s):  ", s)  # 9606c26f3a82e93c9f70859fc0c0aa76acd3b7867ad5d5b748df91f425698a67

# bip62: enforce low S values
if int(s, 16) > ecdsa.SECP256k1.order // 2:
    s = hex(ecdsa.SECP256k1.order - int(s, 16))[2:]
    assert len(s) % 2 == 0
    if len(s) < 64:
        s = '0' * (64 - len(s)) + s
    assert len(s) == 64
print("Low S signature (s):    ", s)  # 69f93d90c57d16c3608f7a603f3f55880ddb25603472ca8476f2cc98aaccb6da

vk: ecdsa.VerifyingKey = sk.verifying_key
print("Public key (compressed):",
      vk.to_string('compressed').hex())  # 03a1328ef6068af52aea4c09f1a31627017acd2ea15a3e23df2760ff1457f77165
assert vk.verify_digest(deterministic_signature, msgHash)
assert vk.verify_digest(bytes.fromhex(r+s), msgHash)

import {broadcastTransaction, makeContractCall, uintCV, standardPrincipalCV, bufferCVFromString, optionalCVOf} from '@stacks/transactions';
import {StacksTestnet, StacksMainnet} from '@stacks/network';
import {bytesToHex} from "@stacks/common";

const txOptions = {
    contractAddress: 'STN3035BW0HRKFJE3E4NHN2867TZN63N9XCGSM1Z',
    contractName: 'ambitious-olive-capybara',
    functionName: 'transfer',
    functionArgs: [uintCV(120),
        standardPrincipalCV('ST24MG3M188B0RGND0PTTXA9RHAYBMNQ53GE6WRQA'),
        standardPrincipalCV('STN3035BW0HRKFJE3E4NHN2867TZN63N9XCGSM1Z'),
        optionalCVOf(bufferCVFromString('sip10 transfer test'))],
    senderKey: '53e804fec042f8fa21c6ab9e8c00d2c879aed9c8737601a8888602848471869a01',
    // attempt to fetch this contracts interface and validate the provided functionArgs
    validateWithAbi: true,
    network: new StacksTestnet(), // for mainnet, use `StacksMainnet()`
};

const tx = await makeContractCall(txOptions);
console.log("txHex", bytesToHex(tx.serialize())) // 8080000000040089480e8142160c42ad05b5aea9388abcba56e51c000000000000000200000000000001050000d58550986a2040495ca86b2ca7c0fd58e9b62f53f27848bf6a07c1568d769bdb6e9b4ad52cb2f5e390ad8d7d0b1f08a03fbb94520eaf98c9736960c080849b4d030200000000021a2a300cabe02389be4e1b8958d44831f5fa98754f18616d626974696f75732d6f6c6976652d6361707962617261087472616e73666572000000040100000000000000000000000000000078051a89480e8142160c42ad05b5aea9388abcba56e51c051a2a300cabe02389be4e1b8958d44831f5fa98754f0a02000000137369703130207472616e736665722074657374
console.log("txId", tx.txid());  // 3bd122ed6e2c8db4da436a9ae3a36ce465337ccd383a9a546193eaa81f6682a5

const broadcastResponse = await broadcastTransaction(tx);
console.log("broadcastResponse", broadcastResponse)