v2 — 使用私钥购买

通过 TronSave v2 API 使用钱包私钥对支付交易进行签名，购买能量或带宽的完整可运行示例。

这是 签名交易 购买流程的完整可运行示例：预估成本、使用钱包私钥构建并签名一笔 TRX 支付交易，然后提交以创建订单。无需预付 TronSave 余额，你可以直接从钱包按订单付款。

整个流程分为三步：

1. 预估 — 调用 /v2/estimate-buy-resource 获取单价以及所需的 TRX。

2. 签名 — 构建一笔发送至 TronSave 接收地址的 sendTrx 交易，并用你的私钥进行签名。

3. 创建订单 — 将签名交易提交至 /v2/buy-resource。

切勿将真实私钥提交到代码仓库。在生产环境运行前，请从环境变量或密钥存储中加载 PRIVATE_KEY。

要求

JavaScript 示例针对 TronWeb 版本 5.3.2：

npm i [email protected] @noble/[email protected]

更多内容请参阅 TronWeb 5.3.2 发布说明。

配置

示例默认使用主网值。若要在 Nile（测试网）上运行，请替换下方内联标注的值：

常量	主网	Nile 测试网
TRONSAVE_RECEIVER_ADDRESS	TWZEhq5JuUVvGtutNgnRBATbF8BnHGyn4S	TATT1UzHRikft98bRFqApFTsaSw73ycfoS
TRON_FULL_NODE	https://api.trongrid.io	https://api.nileex.io
TRONSAVE_API_URL	https://api.tronsave.io	https://api-dev.tronsave.io

有关切换网络的更多信息，请参阅 环境。

完整示例

JavaScript

const {TronWeb} = require('tronweb');

// Configuration constants
const TRONSAVE_RECEIVER_ADDRESS = "TWZEhq5JuUVvGtutNgnRBATbF8BnHGyn4S"; //in testnet mode change it to "TATT1UzHRikft98bRFqApFTsaSw73ycfoS"
const PRIVATE_KEY = "your_private_key"; //Change it
const TRON_FULL_NODE = "https://api.trongrid.io"; //in testnet mode change it to "https://api.nileex.io"
const TRONSAVE_API_URL = "https://api.tronsave.io"; //in testnet mode change it to "https://api-dev.tronsave.io"
const RESOURCE_TYPE = "ENERGY"; // ENERGY or BANDWIDTH

const REQUEST_ADDRESS = "your_request_address"; //Change it
const RECEIVER_ADDRESS = "your_receiver_address"; //Change it
const BUY_AMOUNT = 32000; //Chanageable
const DURATION_SEC = 3600; // 1 hour

// Initialize TronWeb instance
const tronWeb = new TronWeb({
    fullNode: TRON_FULL_NODE,
    solidityNode: TRON_FULL_NODE,
    eventServer: TRON_FULL_NODE,
});

const GetEstimate = async (resourceAmount, durationSec) => {
    const url = TRONSAVE_API_URL + "/v2/estimate-buy-resource";
    const body = {
        resourceAmount,
        unitPrice: "MEDIUM",
        resourceType: RESOURCE_TYPE,
        durationSec,
    };
    const data = await fetch(url, {
        method: "POST",
        headers: {
            "content-type": "application/json",
        },
        body: JSON.stringify(body),
    });
    const response = await data.json();
    /**
     * Example response 
   {
        "error": false,
        "message": 'Success',
        "data": {
            "unitPrice": 50,
            "durationSec": 259200,
            "estimateTrx": 7680000,
            "availableResource": 32000
        }
    }
     */
    return response;
};

const GetSignedTransaction = async (estimateTrx, requestAddress) => {
    const dataSendTrx = await tronWeb.transactionBuilder.sendTrx(TRONSAVE_RECEIVER_ADDRESS, estimateTrx, requestAddress);
    const signedTx = await tronWeb.trx.sign(dataSendTrx, PRIVATE_KEY);
    return signedTx;
};

const CreateOrder = async (resourceAmount, signedTx, receiverAddress, unitPrice, durationSec, options) => {
    const url = TRONSAVE_API_URL + "/v2/buy-resource";
    const body = {
        resourceType: RESOURCE_TYPE,
        resourceAmount,
        unitPrice,
        allowPartialFill: true,
        receiver: receiverAddress,
        durationSec,
        signedTx,
        options
    };
    const data = await fetch(url, {
        method: "POST",
        headers: {
            "content-type": "application/json",
        },
        body: JSON.stringify(body),
    });
    const response = await data.json();
    /**
     * Example response
     * {
     *     "error": false,
     *     "message": "Success",
     *     "data": {
     *         "orderId": "6809fdb7b9ba217a41d726fd"
     *     }
     * }
     */
    return response;
};

/**
 * Main function to buy resources using private key
 * @returns {Promise<void>}
 */
const BuyResourceUsingPrivateKey = async () => {
    //Step 1: Estimate the cost of buy order
    const estimateData = await GetEstimate(BUY_AMOUNT, DURATION_SEC);
    if (estimateData.error) throw new Error(estimateData.message);
    console.log(estimateData);
    const { unitPrice, estimateTrx, durationSec, availableResource } = estimateData.data;
    /*
    {
        "unitPrice": 60,
        "durationSec": 259200,
        "availableResource": 4298470,
        "estimateTrx": 13500000,
    }
     */
    const isReadyFulfilled = availableResource >= BUY_AMOUNT; //if availableResource equal BUY_AMOUNT it means that your order can be fulfilled 100%
    if (isReadyFulfilled) {
        //Step 2: Build signed transaction by using the private key
        const signedTx = await GetSignedTransaction(estimateTrx, REQUEST_ADDRESS);
        console.log(signedTx);
        /*
        {
            "visible": false,
            "txID": "446eed36e31249b98b201db2e81a3825b185f1a3d8b2fea348b24fc021e58e0d",
            "raw_data": {
                "contract": [
                {
                    "parameter": {
                    "value": {
                        "amount": 13500000,
                        "owner_address": "417a0d868d1418c9038584af1252f85d486502eec0",
                        "to_address": "41055756f33f419278d9ea059bd2b21120e6add748"
                    },
                    "type_url": "type.googleapis.com/protocol.TransferContract"
                    },
                    "type": "TransferContract"
                }
                ],
                "ref_block_bytes": "0713",
                "ref_block_hash": "6c5f7686f4176139",
                "expiration": 1691465106000,
                "timestamp": 1691465046758
            },
            "raw_data_hex": "0a02071322086c5f7686f417613940d084b5999d315a68080112640a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412330a15417a0d868d1418c9038584af1252f85d486502eec0121541055756f33f419278d9ea059bd2b21120e6add74818e0fcb70670e6b5b1999d31",
            "signature": ["xxxxxxxxx"]
        }
         */

        //Step 3: Create order
        const dataCreateOrder = await CreateOrder(BUY_AMOUNT, signedTx, RECEIVER_ADDRESS, unitPrice, durationSec);
        console.log(dataCreateOrder);
    }
};
BuyResourceUsingPrivateKey()

Python

PHP

cURL

Go

Java

Rust

只有 JavaScript 示例完整地实现了交易签名（通过 TronWeb）。对于其他语言，签名步骤被留作占位实现 — 请使用对应语言的 TRON SDK 构建并签名一笔发送至 TronSave 接收地址的 TransferContract（sendTrx），或调用 TronSave 的 获取签名交易 API，并将其结果作为 signedTx 传入。

工作原理

步骤	端点	用途
1	POST /v2/estimate-buy-resource	返回 unitPrice、estimateTrx、durationSec 和 availableResource。
2	（钱包 / SDK）	签名一笔发送至 TRONSAVE_RECEIVER_ADDRESS、金额为 estimateTrx SUN 的 sendTrx 交易。
3	POST /v2/buy-resource	提交 signedTx 并创建订单；返回一个 orderId。

示例中的几点说明：

• 预估请求中的 unitPrice: "MEDIUM" 用于选择一个档位；预估响应会返回你传递给 /v2/buy-resource 的具体数值 unitPrice。

• availableResource >= BUY_AMOUNT 表示订单可被完全成交。当设置 allowPartialFill: true 时，即使可用资源较少，订单仍可被创建。

• estimateTrx 以 SUN 计价（1 TRX = 1,000,000 SUN），即你在支付交易中签名的金额。

后续步骤

• 使用签名交易购买（API 参考）

• 预估 TRX · 获取签名交易 · 创建订单

• 环境 · 订单类型