3.2.0

Transaction

Класс Transaction это основной класс, который взаимодействует с блокчейном IOST и смарт-контрактами IOST для отправки и получения от них транзакций.

Метод constructor

Метод constructor это специальный метод для создания и инициализации класса Transaction. НЕТ необходимости для инициализации пользователем, пользователь будет использовать класс Transaction с помощью rpc.transaction.

Метод getTxByHash

получение tx (транзакции) из блокчейна по хешу

Параметры

НазваниеТипОписание
hashStringхеш транзакции кодирован функцией base58

Возвращает

Промис возвращает объект транзакции.

НазваниеТипОписание
statusStringстатус транзакции
transactionObjectОбъект Transaction

Transaction Object (Объект транзакции)

НазваниеТипОписание
hashStringхеш транзакции
timeNumberметка времени транзакции
expirationNumberметка времени истечения транзакции
gas_ratioNumberкоэффицент газа
gas_limitNumberлимит газа
delayNumberзадержка в наносекундах
actionsArrayмассив Action Object
signersArrayмассив строк подписантов
publisherStringотправитель транзакции
referred_txStringхэш указанной транзакции
amount_limitArrayмассив AmountLimit Object
tx_receiptObjectTxReceipt Object

Action Object (Объект Action)

НазваниеТипОписание
contractStringназвание контракта
action_nameStringназвание функции контракта
dataStringданные

AmountLimit Object (Объект AmountLimit)

НазваниеТипОписание
tokenStringназвание токена
valueNumberлимит суммы

TxReceipt Object (Объект квитанция транзакции)

НазваниеТипОписание
tx_hashStringхеш транзакции
gas_usageNumberиспользование газа
ram_usageMapиспользование ram
status_codeStringстатус кода
messageStringсообщение
returnsArrayтранзакция возвращает
receiptsArrayмассив Receipt Object

Receipt Object (Объект квитанция)

НазваниеТипОписание
func_nameStringназвание функции
contentStringсодержание

Пример

const rpc = new IOST.RPC(new IOST.HTTPProvider('http://127.0.0.1:30001'));
rpc.transaction.getTxByHash("5YdA8qPq5N6W47rZV4u31FdbQzeMt2QX9KGj4uPyERZa").then(console.log);

/*{
    "status": "IRREVERSIBLE",
    "transaction": {
        "hash": "5YdA8qPq5N6W47rZV4u31FdbQzeMt2QX9KGj4uPyERZa",
        "time": "0",
        "expiration": "0",
        "gas_ratio": 1,
        "gas_limit": 1000000,
        "delay": "0",
        "actions": [
            {
                "contract": "base.iost",
                "action_name": "Exec",
                "data": "[{\"parent\":[\"IOST2FpDWNFqH9VuA8GbbVAwQcyYGHZxFeiTwSyaeyXnV84yJZAG7A\", \"0\"]}]"
            }
        ],
        "signers": [],
        "publisher": "_Block_Base",
        "referred_tx": "",
        "amount_limit": [],
        "tx_receipt": null
    }
}*/

Метод getTxReceiptByTxHash

получение квитанции транзакции по хешу транзакции

Параметры

НазваниеТипОписание
hashStringхеш транзакции кодирован функцией base58

Возвращает

Промис возвращает Объект TxReceipt

Пример

const rpc = new IOST.RPC(new IOST.HTTPProvider('http://127.0.0.1:30001'));
rpc.transaction.getTxByHash("5YdA8qPq5N6W47rZV4u31FdbQzeMt2QX9KGj4uPyERZa").then(console.log);

/*{
    "tx_hash": "5YdA8qPq5N6W47rZV4u31FdbQzeMt2QX9KGj4uPyERZa",
    "gas_usage": 0,
    "ram_usage": {
        "_Block_Base": "0",
        "base.iost": "284",
        "bonus.iost": "107"
    },
    "status_code": "SUCCESS",
    "message": "",
    "returns": [
        "[\"\"]"
    ],
    "receipts": [
        {
            "func_name": "token.iost/issue",
            "content": "[\"contribute\",\"IOST2FpDWNFqH9VuA8GbbVAwQcyYGHZxFeiTwSyaeyXnV84yJZAG7A\",\"900\"]"
        }
    ]
}*/

sendTx

отправить транзакцию в блокчейн IOST

← KeyPairVM →