createTxObservationArtifact
HardKAS SDK / artifacts/src / createTxObservationArtifact
Function: createTxObservationArtifact()
createTxObservationArtifact(
input,ctx):object
Defined in: packages/artifacts/src/tx-observation.ts:126
Seals ONE observation (v5, FULL). No lineage (IC-2′.5). Refuses an incoherent observation instead of persisting a fact that contradicts itself.
Parameters
input
ctx
RuntimeContext
Returns
object
assumptionLevel?
optionalassumptionLevel?:string
contentHash?
optionalcontentHash?:string
createdAt?
optionalcreatedAt?:string
evidence?
optionalevidence?:object[]
execution?
optionalexecution?:object
execution.domain?
optionaldomain?:"kaspa-l1"|"evm-l2"
execution.mode?
optionalmode?:"rpc"|"simulator"|"localnet"|"l2-rpc"
execution.network?
optionalnetwork?:string
finding?
optionalfinding?: {feeSompi?:string;isOrphan?:boolean;scanComplete?:boolean;scannedChainBlocks?:number;scannedFrom?:string;scannedTo?:string;type?:"mempool_entry"; } | {type?:"mempool_absent"; } | {acceptingBlockHash?:string;acceptingBlueScore?:string;acceptingDaaScore?:string;confirmationsBlue?:string;confirmationsDaa?:string;removedAcceptingBlockHash?:string;type?:"chain_accepted"; } | {acceptingBlockHash?:string;type?:"chain_removed"; } | {acceptingBlockHash?:string;acceptingBlueScore?:string;confirmationsBlue?:string;finalityDepth?:string;type?:"finality_reached"; } | {reason?:string;type?:"pruned_unobservable"; } | {scannedChainBlocks?:number;scannedFrom?:string;scannedTo?:string;type?:"not_found"; } | {receiptArtifactId?:string;type?:"synthetic_executed"; } =TxObservationFindingSchema
Union Members
Type Literal
{ feeSompi?: string; isOrphan?: boolean; scanComplete?: boolean; scannedChainBlocks?: number; scannedFrom?: string; scannedTo?: string; type?: "mempool_entry"; }
feeSompi?
optionalfeeSompi?:string
isOrphan?
optionalisOrphan?:boolean
scanComplete?
optionalscanComplete?:boolean
scannedChainBlocks?
optionalscannedChainBlocks?:number
scannedFrom?
optionalscannedFrom?:string
MEMPOOL-CHAIN-PRECEDENCE-FIX-1: the chain window the same look read (absent in historical observations and when
the node served no batch). scannedTo is the last chain block read — the next cursor; scanComplete is false when
the scan stopped before the node's selected-chain tip.
scannedTo?
optionalscannedTo?:string
type?
optionaltype?:"mempool_entry"
Type Literal
{ type?: "mempool_absent"; }
Type Literal
{ acceptingBlockHash?: string; acceptingBlueScore?: string; acceptingDaaScore?: string; confirmationsBlue?: string; confirmationsDaa?: string; removedAcceptingBlockHash?: string; type?: "chain_accepted"; }
acceptingBlockHash?
optionalacceptingBlockHash?:string
acceptingBlueScore?
optionalacceptingBlueScore?:string=decimalString
acceptingDaaScore?
optionalacceptingDaaScore?:string
confirmationsBlue?
optionalconfirmationsBlue?:string=decimalString
confirmationsDaa?
optionalconfirmationsDaa?:string
removedAcceptingBlockHash?
optionalremovedAcceptingBlockHash?:string
The block this observer previously saw accepting the transaction, which the SAME node answer
reported off the selected chain: the acceptance moved to acceptingBlockHash, it was not lost.
type?
optionaltype?:"chain_accepted"
Type Literal
{ acceptingBlockHash?: string; type?: "chain_removed"; }
Type Literal
{ acceptingBlockHash?: string; acceptingBlueScore?: string; confirmationsBlue?: string; finalityDepth?: string; type?: "finality_reached"; }
Type Literal
{ reason?: string; type?: "pruned_unobservable"; }
Type Literal
{ scannedChainBlocks?: number; scannedFrom?: string; scannedTo?: string; type?: "not_found"; }
scannedChainBlocks?
optionalscannedChainBlocks?:number
scannedFrom?
optionalscannedFrom?:string
scannedTo?
optionalscannedTo?:string
The last chain block the scan reached: the next observation's cursor.
type?
optionaltype?:"not_found"
Type Literal
{ receiptArtifactId?: string; type?: "synthetic_executed"; }
hardkasVersion?
optionalhardkasVersion?:string
hashVersion?
optionalhashVersion?:string|number
lineage?
optionallineage?:object
lineage.artifactId?
optionalartifactId?:string
lineage.lineageId?
optionallineageId?:string
lineage.parentArtifactId?
optionalparentArtifactId?:string
lineage.rootArtifactId?
optionalrootArtifactId?:string
lineage.sequence?
optionalsequence?:number
lineageDepth?
optionallineageDepth?:number
metadata?
optionalmetadata?:any
mode?
optionalmode?:"rpc"|"simulator"|"localnet"=executionModeSchema
networkId?
optionalnetworkId?:"simnet"|"mainnet"|"testnet-10"|"testnet-11"|"testnet-12"|"simnet-1"|"devnet"|"simulated"|"igra"=kaspaNetworkIdSchema
observedAt?
optionalobservedAt?:string
observer?
optionalobserver?:object
observer.capabilities?
optionalcapabilities?:object
observer.capabilities.prunedBelowBlueScore?
optionalprunedBelowBlueScore?:string
observer.capabilities.reorgAware?
optionalreorgAware?:boolean
observer.description?
optionaldescription?:string
Interim until D-Q1.a: describes the observer; it does NOT identify a node cryptographically.
observer.kind?
optionalkind?:"rpc"|"synthetic"