emit

Conceitos

Transações Emitidas

Comportamento

C

• Lê uma transação a partir de read_ptr
• Valida a transação contra as regras de emissão
• Emite a transação para o consenso quando válida
• Escreve o hash canônico da transação em write_ptr

JavaScript

• Esta função emite o JSON de transação fornecido.
• Em caso de sucesso, retorna o número de hashes de transações emitidas.
• Se houver um erro, retorna um código de erro.

Definição

C

int64_t emit (
    uint32_t write_ptr,
    uint32_t write_len,
    uint32_t read_ptr,
    uint32_t read_len
);

JavaScript

function emit(
    txJson: Record<string, any> | Transaction
  ): ErrorCode | ByteArray

Exemplo

C

if (emit(tx, tx_len) < 0)
    rollback("Failed to emit!", 15, 1);

JavaScript

const emitResult = emit(txJson)
if(typeof emitResult === 'number')
    rollback("Failed to emit!", 1)

Parâmetros

C

Nome	Tipo	Descrição
write_ptr	uint32_t	Ponteiro para um buffer onde escrever o hash da transação
write_len	uint32_t	O tamanho do buffer para escrever o hash da transação (deve ser 32.)
read_ptr	uint32_t	Ponteiro para a transação a ser emitida
read_len	uint32_t	O tamanho da transação

JavaScript

Nome	Tipo	Descrição
txJson	Record<string, any> | Transaction	O TX JSON a ser emitido.

Código de Retorno

C

Tipo

Descrição

int64_t

Em caso de sucesso, o número de bytes do hash da transação escritos (32), ou: Se negativo, um erro: OUT_OF_BOUNDS - ponteiros/tamanhos especificados fora da memória do hook. PREREQUISITE_NOT_MET - emit_reserve deve ser chamado primeiro TOO_MANY_EMITTED_TXN - o número de transações emitidas agora é maior do que o prometido quando emit_reserve foi chamado anteriormente EMISSION_FAILURE - a transação estava malformada de acordo com as regras de emissão.

JavaScript

Tipo	Descrição
ErrorCode | ByteArray	Retorna um ErrorCode se houver um erro, ou um array de hashes de transações emitidas em caso de sucesso.