SDK#

此 SDK 提供了铭文的铭刻和转移功能，包括 btc、nft 和 brc20 代币等。

铭刻铭文#

1.简介#

为了铭刻铭文，您可以使用Inscribe功能，只需提供输入的UTXOs和铭文数据，请参阅示例了解详细信息。

2.参数#

参数	类型	描述	备注
CommitTxPrevOutputList	[]*PrevOutput	用于铭文的UTXO列表
CommitFeeRate	int64	CommitTx的费率
RevealFeeRate	int64	RevealTx的费率
RevealOutValue	int64	RevealTx的输出金额	[可选] 默认为546
InscriptionDataList	[]InscriptionData	铭文内容列表
ChangeAddress	string	接收找零的地址

PrevOutput

参数	类型	描述
TxId	string	UTXO所在的交易ID
VOut	uint32	输出偏移量
Amount	int64	输出金额
Address	string	输出地址
PrivateKey	string	WIF编码的私钥

InscriptionData

参数	类型	描述
ContentType	string	铭文内容类型
Body	[]byte	铭文数据
RevealAddr	string	铭文绑定地址

3.请求示例#

network := &chaincfg.TestNet3Params

commitTxPrevOutputList := make([]*PrevOutput, 0)
commitTxPrevOutputList = append(commitTxPrevOutputList, &PrevOutput{
    TxId:       "42323b006e7433c7010cb8025de3f018621c5bce882e35f97009d9313ce4b840",
    VOut:       0,
    Amount:     546,
    Address:    "tb1qtsq9c4fje6qsmheql8gajwtrrdrs38kdzeersc",
    PrivateKey: "cPnvkvUYyHcSSS26iD1dkrJdV7k1RoUqJLhn3CYxpo398PdLVE22",
})
commitTxPrevOutputList = append(commitTxPrevOutputList, &PrevOutput{
    TxId:       "78d81df15795206560c5f4f49824a38deb0a63941c6d593ca12739b2d940c8cd",
    VOut:       2,
    Amount:     100000,
    Address:    "2NF33rckfiQTiE5Guk5ufUdwms8PgmtnEdc",
    PrivateKey: "cPnvkvUYyHcSSS26iD1dkrJdV7k1RoUqJLhn3CYxpo398PdLVE22",
})
commitTxPrevOutputList = append(commitTxPrevOutputList, &PrevOutput{
    TxId:       "a48400e329681c2524b939ffbafda3a5a0f5f6329015375298fc6703e3bed552",
    VOut:       0,
    Amount:     546,
    Address:    "mouQtmBWDS7JnT65Grj2tPzdSmGKJgRMhE",
    PrivateKey: "cPnvkvUYyHcSSS26iD1dkrJdV7k1RoUqJLhn3CYxpo398PdLVE22",
})
commitTxPrevOutputList = append(commitTxPrevOutputList, &PrevOutput{
    TxId:       "78d81df15795206560c5f4f49824a38deb0a63941c6d593ca12739b2d940c8cd",
    VOut:       3,
    Amount:     246500,
    Address:    "tb1pklh8lqax5l7m2ycypptv2emc4gata2dy28svnwcp9u32wlkenvsspcvhsr",
    PrivateKey: "cPnvkvUYyHcSSS26iD1dkrJdV7k1RoUqJLhn3CYxpo398PdLVE22",
})

inscriptionDataList := make([]InscriptionData, 0)
inscriptionDataList = append(inscriptionDataList, InscriptionData{
    ContentType: "text/plain;charset=utf-8",
    Body:        []byte(`{"p":"brc-20","op":"mint","tick":"xcvb","amt":"1000"}`),
    RevealAddr:  "tb1qtsq9c4fje6qsmheql8gajwtrrdrs38kdzeersc",
})
inscriptionDataList = append(inscriptionDataList, InscriptionData{
    ContentType: "text/plain;charset=utf-8",
    Body:        []byte(`{"p":"brc-20","op":"mint","tick":"xcvb","amt":"1000"}`),
    RevealAddr:  "2NF33rckfiQTiE5Guk5ufUdwms8PgmtnEdc",
})
inscriptionDataList = append(inscriptionDataList, InscriptionData{
    ContentType: "text/plain;charset=utf-8",
    Body:        []byte(`{"p":"brc-20","op":"mint","tick":"xcvb","amt":"1000"}`),
    RevealAddr:  "mouQtmBWDS7JnT65Grj2tPzdSmGKJgRMhE",
})
inscriptionDataList = append(inscriptionDataList, InscriptionData{
    ContentType: "text/plain;charset=utf-8",
    Body:        []byte(`{"p":"brc-20","op":"mint","tick":"xcvb","amt":"1000"}`),
    RevealAddr:  "tb1pklh8lqax5l7m2ycypptv2emc4gata2dy28svnwcp9u32wlkenvsspcvhsr",
})

request := &InscriptionRequest{
    CommitTxPrevOutputList: commitTxPrevOutputList,
    CommitFeeRate:          2,
    RevealFeeRate:          2,
    RevealOutValue:         546,
    InscriptionDataList:    inscriptionDataList,
    ChangeAddress:          "2NF33rckfiQTiE5Guk5ufUdwms8PgmtnEdc",
}

requestBytes, _ := json.Marshal(request)
log.Println(string(requestBytes))

txs, _ := Inscribe(network, request)

txsBytes, _ := json.Marshal(txs)
t.Log(string(txsBytes))

4.返回值#

需要广播的交易。

转移铭文#

1.简介#

为了转移铭文，您可以使用 Transfer 函数来转移铭文，支持4种类型的地址输入，请参阅示例以了解详细信息。 注意sat的位置变化规则，并确保正确转移绑定到sat的铭文。

2.参数#

输入

参数	类型	描述	备注
TxId	string	UTXO所在的交易ID
VOut	uint32	输出偏移
Amount	int64	输出金额
Address	string	输出地址
PrivateKey	string	以WIF编码的私钥
NonWitnessUtxo	string	UTXO所在的交易的十六进制表示	[可选] 需要p2pkh地址

输出

参数	类型	描述
Address	string	输出地址
Amount	int64	输出金额

3.请求示例#

network := &chaincfg.TestNet3Params

var inputs []*TxInput
inputs = append(inputs, &TxInput{
    TxId:       "25b9d08a26c8d47795301dd47a861cff0459d14f27fbd41cffaca17d9aa20f87",
    VOut:       uint32(0),
    Amount:     int64(249352),
    Address:    "tb1qtsq9c4fje6qsmheql8gajwtrrdrs38kdzeersc",
    PrivateKey: "cPnvkvUYyHcSSS26iD1dkrJdV7k1RoUqJLhn3CYxpo398PdLVE22",
})
inputs = append(inputs, &TxInput{
    TxId:           "6d59aa50447c0d55e6f9535c3e56d7014b4ca8070ee57ce2199219790cfd5815",
    VOut:           uint32(0),
    Amount:         int64(499356),
    Address:        "mouQtmBWDS7JnT65Grj2tPzdSmGKJgRMhE",
    PrivateKey:     "cPnvkvUYyHcSSS26iD1dkrJdV7k1RoUqJLhn3CYxpo398PdLVE22",
    NonWitnessUtxo: "02000000010a6b13715c8effde51dac60d572358005a589cd80413a88e0912e4c6d275abbe010000006a473044022019e34aa16cf55eb9c7a8627f61bcd671525a3818a23ab8a78af13c35121ea3c8022055a5bfb3e8486f6e83707660f1fca3da06f140f449902a63900625f43fadf10501210357bbb2d4a9cb8a2357633f201b9c518c2795ded682b7913c6beef3fe23bd6d2fffffffff019c9e0700000000001976a9145c005c5532ce810ddf20f9d1d939631b47089ecd88ac00000000",
})
// inscription
inputs = append(inputs, &TxInput{
    TxId:       "46e3ce050474e6da80760a2a0b062836ff13e2a42962dc1c9b17b8f962444206",
    VOut:       uint32(0),
    Amount:     int64(546),
    Address:    "tb1pklh8lqax5l7m2ycypptv2emc4gata2dy28svnwcp9u32wlkenvsspcvhsr",
    PrivateKey: "cPnvkvUYyHcSSS26iD1dkrJdV7k1RoUqJLhn3CYxpo398PdLVE22",
})
inputs = append(inputs, &TxInput{
    TxId:       "d1696c10046ec8b2d938924f1923f1f2e1588095fbf3ea0f8cd640b51da51ba2",
    VOut:       uint32(0),
    Amount:     int64(400),
    Address:    "2NF33rckfiQTiE5Guk5ufUdwms8PgmtnEdc",
    PrivateKey: "cPnvkvUYyHcSSS26iD1dkrJdV7k1RoUqJLhn3CYxpo398PdLVE22",
})

var outputs []*TxOutput
outputs = append(outputs, &TxOutput{
    Address: "tb1qtsq9c4fje6qsmheql8gajwtrrdrs38kdzeersc",
    Amount:  int64(200000),
})
outputs = append(outputs, &TxOutput{
    Address: "mouQtmBWDS7JnT65Grj2tPzdSmGKJgRMhE",
    Amount:  int64(200000),
})
outputs = append(outputs, &TxOutput{
    Address: "2NF33rckfiQTiE5Guk5ufUdwms8PgmtnEdc",
    Amount:  int64(100000),
})
outputs = append(outputs, &TxOutput{
    Address: "tb1pklh8lqax5l7m2ycypptv2emc4gata2dy28svnwcp9u32wlkenvsspcvhsr",
    Amount:  int64(246500),
})
outputs = append(outputs, &TxOutput{
    Address: "tb1pklh8lqax5l7m2ycypptv2emc4gata2dy28svnwcp9u32wlkenvsspcvhsr",
    Amount:  int64(1000),
})
outputs = append(outputs, &TxOutput{
    Address: "tb1pklh8lqax5l7m2ycypptv2emc4gata2dy28svnwcp9u32wlkenvsspcvhsr",
    Amount:  int64(1000),
})

signedTx, err := Transfer(inputs, outputs, network)
if err != nil {
    t.Fatal(err)
}
t.Log(signedTx)

4.返回值#

需要广播的交易。