codama-idl-codama/packages/nodes/docs/RootNode.md

RootNode

This node represents the starting point of the Kinobi IDL. It contains a single ProgramNode which the Kinobi IDL is describing as well as any additional programs that may be referenced by the main program. This node is also responsible for setting the standard and version of the IDL.

Attributes

Data

Attribute	Type	Description
kind	"rootNode"	The node discriminator.
standard	"kinobi"	The IDL standard used by the RootNode which is always "kinobi". This can help other communities fork the Kinobi standard.
version	\d.\d.\d	The semantic version of the standard used by the RootNode. That is — unless a different standard is used — this will be the Kinobi version from which this entire tree of node was created.

Children

Attribute	Type	Description
program	ProgramNode	The main program being described.
additionalPrograms	ProgramNode[]	(Optional) Additional programs that are referenced by the main program.

Functions

rootNode(program, additionalPrograms?)

Helper function that creates a RootNode object from a ProgramNode and an optional array of additional ProgramNodes. Note that the standard is automatically set to "kinobi" and the version is set to the Kinobi version installed.

const node = rootNode(programNode({ ... }));

Examples

A root node with a single program

const node = rootNode(
    programNode({
        name: 'counter',
        publicKey: '2R3Ui2TVUUCyGcZdopxJauk8ZBzgAaHHZCVUhm5ifPaC',
        version: '1.0.0',
        accounts: [
            accountNode({
                name: 'counter',
                data: structTypeNode([
                    structFieldTypeNode({ name: 'authority', type: publicKeyTypeNode() }),
                    structFieldTypeNode({ name: 'value', type: numberTypeNode('u32') }),
                ]),
            }),
        ],
        instructions: [
            instructionNode({ name: 'create' /* ... */ }),
            instructionNode({ name: 'increment' /* ... */ }),
            instructionNode({ name: 'transferAuthority' /* ... */ }),
            instructionNode({ name: 'delete' /* ... */ }),
        ],
    }),
);