Cron

[Fonte]

(Adicionado pela [emenda Cron][].)

A pseudo-transação Cron é automaticamente inserida no ledger pelo motor Cron quando uma execução de Hook agendada está devida. Esta pseudo-transação aciona a execução do Hook na conta especificada no campo Owner.

Exemplo

{
  "TransactionType": "Cron",
  "Account": "rrrrrrrrrrrrrrrrrrrrrhoLvTp",
  "Fee": "0",
  "LedgerSequence": 21225473,
  "Sequence": 0,
  "SigningPubKey": "",
  "TxnSignature": "",
  "Owner": "rWYkbWkCeg8dP6rXALnjgZSjjLyih5NXm"
}

Campos

Campo	Tipo JSON	[Tipo Interno][]	Descrição
Owner	String	AccountID	A conta que possui a execução de Hook agendada. Esta é a conta que será invocada quando o cron executar.
LedgerSequence	Number	UInt32	O [índice de ledger][] onde esta pseudo-transação aparece. Isso distingue a pseudo-transação de outras ocorrências da mesma mudança.

Campos Comuns

Como pseudo-transação, Cron usa os valores padrão de pseudo-transação para campos comuns:

Campo	Valor
Account	rrrrrrrrrrrrrrrrrrrrrhoLvTp (ACCOUNT_ZERO)
Fee	0
Sequence	0
SigningPubKey	"" (string vazia)
TxnSignature	"" (string vazia)

Comportamento de Execução

Quando um objeto de ledger Cron está pronto para executar (com base nos campos StartTime, DelaySeconds e RepeatCount), o motor Cron insere automaticamente uma pseudo-transação Cron no ledger.

A pseudo-transação contém um campo Owner que referencia a conta com o Hook agendado. O Hook nessa conta será invocado automaticamente, e a conta é tratada como um parte interessada transacional fraca (TSH) durante a execução.

Importante: Os desenvolvedores de Hook devem habilitar chamadas de coleta (flag hsfCOLLECT) em seus Hooks, pois o Owner constitui uma parte interessada transacional fraca quando a pseudo-transação Cron é executada. A conta também deve ter o flag asfTshCollect habilitado.

Documentação Relacionada

• Transação CronSet: Cria, atualiza ou exclui execuções de Hook agendadas
• Objeto de ledger Cron: O objeto de ledger que representa uma execução de Hook agendada
• Fraco e Forte: Entendendo partes interessadas transacionais
• Hooks de Chamada de Coleta: Como Hooks de TSH fraco são executados