钱包与账户

在 Stacks 中，“地址”和“主体（principal）”这两个术语可以互换使用。

介绍

Stacks 钱包是用于存储加密货币、NFT 和其他数字资产的软件或硬件工具。它们也用于在去中心化应用（dApp）中建立链上身份。这些钱包通过单一区块链地址以密码学方式存储和管理每个用户的身份和资金，利用公钥密码学。

Stacks 钱包的用途

• 建立用户身份

• 存储资产

• 显示余额

• 签署交易

• 签署消息

• 参与比特币经济

Stacks 中的钱包由账户组成，使用基于账户的模型，而不是像比特币那样的 UTXO 模型。该模型比 UTXO 模型更简单，并具有更传统的“余额”概念，类似于银行中的账户。在此模型中，每个地址对给定代币只有一个“余额”数字，随着交易发送到/从该账户发送而增加/减少。这也是大多数 Web3 生态系统使用的方式。在 UTXO 模型中，网络作为分类账运行，每个 UTXO 类似于一张现金票据。

Stacks 账户的组成部分

• 私钥 - 私钥是与单个公钥按 1:1 配对的字母数字代码。切勿与任何人共享您的私钥。私钥用于证明对公钥的所有权以及如何花费由该密钥对持有的资产。 Stacks 中的示例私钥（32 字节后附加 0x01 字节）： 5a4133fec2cf923d37238d3ba2fcd2ee9c8dce882c22218fd210d8a02ceb2c7401

• 公钥 - 公钥是通过数学方式从私钥派生出来的。它可以安全共享，网络会使用公钥来验证由私钥创建的签名，而不会泄露私钥本身。 Stacks 中的示例公钥（压缩格式）： 02e8eb87862945d369511fdcce326ffef9a01b68c7d070e3ce685a5cbb9b1ecfc5

• 地址（主体） - 地址是从公钥派生的更短、更易于用户识别的表示。它是您在 Stacks 上接收 sBTC、STX、代币或 NFT 时共享的内容，并且作为用户的链上标识符。 Stacks 中的示例公开地址（c32check 编码）： SPM9G3CNGSCTB4956290NESM0MR9W9CCEPVEPSQC

私/公钥生成使用的密码学为 secp256k1 曲线。

Stacks 中使用的密码学签名算法是 ECDSA 基于 secp256k1.

地址的创建方式是先生成 RIPEMD-160 对 SHA256 公钥进行哈希。BTC 地址使用 Base58Check编码。对于 Stacks 地址， c32check 被使用。

Stacks 账户是拥有资产（例如 Stacks (STX) 代币）的实体。一个账户具有地址、私钥、nonce 和一个或多个资产余额。未经账户所有者的操作，资产无法离开账户。对资产（以及账户余额）的所有更改都需要相应的交易。

所有 Stacks 钱包也支持比特币地址，从而实现跨 Stacks 与比特币生态的无缝参与。

地址格式

Stacks 地址使用不同的前缀来指示它们所属的网络，便于区分主网和测试网地址。

// 主网地址以 'SP' 开头
const mainnetAddress = 'SP3FGQ8Z7JY9BWYZ5WM53E0M9NK7WHJF0691NZ159';

// 主网多重签名地址以 'SM' 开头
const multisigMainnetAddress = 'SM3VDXK3WZZSA84XXFKAFAF15NNZX32CTSG82JFQ4'

// 测试网多重签名地址以 'SN' 开头
const multisigTestnetAddress = 'SNJSPGVBFZHPXGESC9ZQWVFSNF4RHNNRTW2HYYJ7'

// 测试网地址以 'ST' 开头
const testnetAddress = 'ST2F4BK4GZH6YFBNHYDDGN4T1RKBA7DA1BJZPJEJJ';

---

如何创建 Stacks 账户？

钱包的账户是从符合 BIP39 标准的 24 个单词助记词短语生成的。这通常称为 种子短语（seed phrase）。种子短语提供对 Stacks 账户的访问。

如果种子短语丢失，则无法恢复对关联账户的访问。任何个人或组织都无法恢复丢失的种子短语。

开发者和非开发者都可以通过几种不同的方法来创建 Stacks 账户。

1

使用 Stacks.js

对于以程序方式生成钱包或从备份恢复账户，您可以从助记词种子短语派生地址。每个钱包可以包含多个账户，这些账户都从同一助记词通过不同的派生路径派生出来。

import { generateWallet, generateSecretKey, type Wallet, Account } from '@stacks/wallet-sdk';
import { privateKeyToAddress, privateKeyToPublic } from '@stacks/transactions'

// 生成新的 24 字助记词短语
const secretKey: string = generateSecretKey();

// 或使用现有的助记词短语
// const secretKey = 'already owned seed phrase ...';

const wallet: Wallet = await generateWallet({
  secretKey,
  password: 'optional-encryption-password',
});

// 获取第一个账户的公钥和地址
const account: Account = wallet.accounts[0];
const publicKey = privateKeyToPublic(account.stxPrivateKey);
const mainnetAddress = privateKeyToAddress(account.stxPrivateKey, 'mainnet');

console.log('Private key:', account.stxPrivateKey);
console.log('Address:', mainnetAddress);
// Private key: 97ff523937735dc6c9e3180f98a6aa94f526fbe072230b99e07482260f59988c01
// Address: SP1WNA65XE3M665RJ9AC81J18XPMJ5QC5XJDHWXE

有关以编程方式生成密钥和账户的更多方法，请查看指南 此处.

2

使用 Stacks CLI 工具

使用 Stacks CLI 工具可让您在命令行上管理钱包。

make_keychain

# 全局安装 CLI
npm install --global @stacks/cli

# 生成一个新账户并将详细信息存储在新文件中。
# '-t' 选项将其设为测试网账户
stx make_keychain -t > cli_keychain.json

# make_keychain 输出如下：
{
  "mnemonic": "aaa bbb ccc ddd ...",
  "keyInfo": {
    "privateKey": "5a3f1f15245bb3fb...",
    "address": "STJRM2AMVF90ER6G3RW1QTF85E3HZH37006D5ER1",
    "btcAddress": "biwSd6KTEvJcyX2R8oyfgj5REuLzczMYC1",
    "wif": "L4HXn7PLmzoNW...",
    "index": 0
  }
}

get_address

# 获取私钥或多重签名私钥包的地址。
# 返回 BTC 和 STACKS 地址

stx get_address f5185b9ca93bdcb5753fded3b097dab8547a8b47d2be578412d0687a9a0184cb01
{
  "BTC": "1JFhWyVPpZQjbPcXFtpGtTmU22u4fhBVmq",
  "STACKS": "SP2YM3J4KQK09V670TD6ZZ1XYNYCNGCWCVVKSDFWQ"
}

stx get_address 1,f5185b9ca93bdcb5753fded3b097dab8547a8b47d2be578412d0687a9a0184cb01,ff2ff4f4e7f8a1979ffad4fc869def1657fd5d48fc9cf40c1924725ead60942c01
{
  "BTC": "363pKBhc5ipDws1k5181KFf6RSxhBZ7e3p",
  "STACKS": "SMQWZ30EXVG6XEC1K4QTDP16C1CAWSK1JSWMS0QN"
}

有关更多使用示例，请查看 Stacks CLI 仓库 此处.

3

使用比特币 L2 钱包扩展/应用

有许多支持比特币层和元协议的流行比特币钱包。Leather 和 Xverse 是开始使用 Stacks 的流行选项。

4

使用其他社区构建的工具

查看 Stacks 开发工具目录 以获取用于创建和管理 Stacks 钱包的其他创意开发工具。

---

Clarity 合约地址如何格式化？

在 Stacks 上， 合约地址/主体 唯一标识已部署的智能合约，其结构为账户主体加上合约命名空间，形成唯一的链上标识：

<deployer-address>.<contract-name>

结构解析

1. 部署者地址 一个标准的 Stacks 主体（由公钥的 hash160 派生），例如：

   • SP... → 主网

   • ST... → 测试网

2. 合约名称 在部署时选择的 ASCII 标识符（例如， my-token, amm-v1, nft-market).

为什么采用这种结构

因为合约标识符是按部署者地址进行命名空间划分的：

• 两个不同的账户可以部署同名合约。

• 单个账户不能部署两个同名合约。

• 该标识符是确定性的并且全局唯一。

---

处理不同的格式

新接触 Stacks 的开发者在指定 Stacks 的主体（即地址）时常常会被不同的表示方式所困扰。

下面是应对三种不同使用场景中主体处理方式的说明。

---

Stacks 与比特币地址之间的关联

使 Stacks 与其 L1 清算层比特币紧密相连的要点之一是它们的许多共享特性。其中之一是两者都基于 P2PKH 格式使用类似的地址生成方案，这允许比特币和 Stacks 地址共享相同的公钥哈希。如果你对一个传统的比特币地址进行 base58check 解码，就可以揭示公钥哈希，然后可以用它来生成相应的 c32check 编码的 Stacks 地址。

以编程方式，你也可以使用一种称为 b58ToC32的方法，来自 c32check javascript 库，它可以为你抽象处理转换。

---

附加资源

• [Hiro 博客] 理解比特币地址格式之间的差异

• [Hiro 博客] 每个 Stacks 地址为何都有对应的比特币地址

• [Hiro 博客] 面向 Web3 创业者的 Web3 钱包入门

• [Hiro 博客] 为什么 Web3 需要以比特币为中心的钱包标准

• [Stacks YouTube 频道] 如何设置你的第一个比特币 L2 钱包

• [SIP-005] 有关钱包/账户生成方式的技术分解和标准。