普贤教程 › 包参考

base58 包

Base58 / Base58Check 编码

项	值
包名	`base58`
版本	`0.2.0`
可用版本	`0.1.0 / 0.2.0`
入口	`base58.px`
分类	`数据格式与编解码`
文件数 / 行数	`1 / 220`

安装与引入

bash

pxpkg init          # 首次
pxpkg add base58@0.2.0
pxpkg install

import base58

所属分类教程：数据格式与编解码

公开接口

函数	参数
`base58_encode`	`s`
`base58_decode`	`s`
`base58check_encode`	`s`
`base58check_decode`	`s`

其余 9 个 def（内部与辅助，可直接调用但不属稳定接口）

函数	参数
`b58_val`	`c`
`b58_encode_bytes`	`raw`
`b58_hex2`	`n`
`b58_append_byte`	`b, n`
`b58_double_sha256_hex`	`s`
`base58_encode_int`	`n`
`base58_decode_int`	`s`
`base58_is_valid`	`s`
`base58_encode_hex`	`hex_str`

包内说明（源码头注释）

text

============================================================
普贤生态库：registry/base58 —— Base58 / Base58Check 编码
------------------------------------------------------------
纯函数库（无 IO、无状态），编译（px build）与解释（px run）双模式一致。
base58_encode(s)        → str     字节串 → Base58
base58_decode(s)        → Ok(str) | Err
base58check_encode(s)   → str     4 字节校验（双 SHA-256 前 4 字节）附加
base58check_decode(s)   → Ok(str) | Err（校验失败 → Err）
字母表：Bitcoin 标准
"123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz"（去 0/O/I/l）
实现：大数除 58 / 除 256 的长除法（无 64 位溢出，可处理任意长度输入）；
前导 0 字节 → 前缀 '1'（编码）/ 前导 '1' → 0x00 字节（解码）。
说明：PuXian 字符串为字节串，任意二进制可原样承载（\x00 等）。
============================================================