Nosana Jobs

About 22 min

Nosana Jobs

Projects can post pipeline jobs through the Nosana Jobs program.
It lets nodes in the Nosana Network earn tokens by doing those jobs.

Program Information

Info	Description
Type	Solana Programopen in new window
Source Code	GitHubopen in new window
Build Status	Anchor Verifiedopen in new window
Accounts	`4`
Instructions	`19`
Types	`3`
Errors	`19`
Domain	`nosana-jobs.sol`
Address	`nosJhNRqr2bc9g1nfGDcXXTXvYUmxD4cVwy2pMWhrYM`open in new window

Instructions

A number of 19 instruction are defined in the Nosana Jobs program.

To load the program with Anchoropen in new window.

const programId = new PublicKey('nosJhNRqr2bc9g1nfGDcXXTXvYUmxD4cVwy2pMWhrYM');
const idl = await Program.fetchIdl(programId.toString());
const program = new Program(idl, programId);

Open

Initialize a MarketAccount and VaultAccount.

Account Info

The following 8 account addresses should be provided when invoking this instruction.

Name	Type	Description
`mint`		The token Mint address for this instruction.
`market`		The MarketAccount address.
`vault`		The VaultAccount address.
`authority`		The signing authority of the program invocation.
`accessKey`		The Node Access Key address.
`rent`		The official Solana rent address. Responsible for lamports.
`systemProgram`		The official Solana system program address. Responsible for system CPIs.
`tokenProgram`		The official SPL Token Program address. Responsible for token CPIs.

Arguments

The following 5 arguments should also be provided when invoking this instruction.

Name	Type	Size	Offset	Description
`jobExpiration`	`i64`	`16`	`0`	The expiration time in seconds for jobs.
`jobPrice`	`u64`	`8`	`16`	The price for jobs in this market.
`jobTimeout`	`i64`	`16`	`24`	The timeout time in seconds for jobs.
`jobType`	`u8`	`1`	`40`	The JobType number.
`nodeXnosMinimum`	`u128`	`16`	`41`	The amount of `xNOS` a node needs to qualify for a market.

Solana Dispatch ID

The Solana dispatch ID for the Open Instruction
is e4dc9b47c7bd3c2d,
which can also be expressed as an 8 byte discriminator:

[228,220,155,71,199,189,60,45]

Example with Anchor

To invoke the Open Instruction
with Anchor TSopen in new window.

let tx = await program.methods
  .open(
    jobExpiration,     // type: i64
    jobPrice,          // type: u64
    jobTimeout,        // type: i64
    jobType,           // type: u8
    nodeXnosMinimum,   // type: u128
  )
  .accounts({
    mint,              // 𐄂 writable, 𐄂 signer
    market,            // ✓ writable, ✓ signer
    vault,             // ✓ writable, 𐄂 signer
    authority,         // ✓ writable, ✓ signer
    accessKey,         // 𐄂 writable, 𐄂 signer
    rent,              // 𐄂 writable, 𐄂 signer
    systemProgram,     // 𐄂 writable, 𐄂 signer
    tokenProgram,      // 𐄂 writable, 𐄂 signer
  })
  .signers([marketKey, authorityKey])
  .rpc();

Update

Update a MarketAccount's configurations.

Account Info

The following 3 account addresses should be provided when invoking this instruction.

Name	Type	Description
`market`		The MarketAccount address.
`accessKey`		The Node Access Key address.
`authority`		The signing authority of the program invocation.

Arguments

The following 5 arguments should also be provided when invoking this instruction.

Name	Type	Size	Offset	Description
`jobExpiration`	`i64`	`16`	`0`	The expiration time in seconds for jobs.
`jobPrice`	`u64`	`8`	`16`	The price for jobs in this market.
`jobType`	`u8`	`1`	`24`	The JobType number.
`nodeStakeMinimum`	`u128`	`16`	`25`	The amount of `xNOS` a node needs to qualify for a market.
`jobTimeout`	`i64`	`16`	`41`	The timeout time in seconds for jobs.

Solana Dispatch ID

The Solana dispatch ID for the Update Instruction
is dbc858b09e3ffd7f,
which can also be expressed as an 8 byte discriminator:

[219,200,88,176,158,63,253,127]

Example with Anchor

To invoke the Update Instruction
with Anchor TSopen in new window.

let tx = await program.methods
  .update(
    jobExpiration,     // type: i64
    jobPrice,          // type: u64
    jobType,           // type: u8
    nodeStakeMinimum,  // type: u128
    jobTimeout,        // type: i64
  )
  .accounts({
    market,            // ✓ writable, 𐄂 signer
    accessKey,         // 𐄂 writable, 𐄂 signer
    authority,         // 𐄂 writable, ✓ signer
  })
  .signers([authorityKey])
  .rpc();

Close

Close a MarketAccount and the associated VaultAccount.

Account Info

The following 5 account addresses should be provided when invoking this instruction.

Name	Type	Description
`market`		The MarketAccount address.
`vault`		The VaultAccount address.
`user`		The user token account that will debit/credit the tokens.
`authority`		The signing authority of the program invocation.
`tokenProgram`		The official SPL Token Program address. Responsible for token CPIs.

Solana Dispatch ID

The Solana dispatch ID for the Close Instruction
is 62a5c9b16c41ce60,
which can also be expressed as an 8 byte discriminator:

[98,165,201,177,108,65,206,96]

Example with Anchor

To invoke the Close Instruction
with Anchor TSopen in new window.

let tx = await program.methods
  .close()
  .accounts({
    market,            // ✓ writable, 𐄂 signer
    vault,             // ✓ writable, 𐄂 signer
    user,              // ✓ writable, 𐄂 signer
    authority,         // 𐄂 writable, ✓ signer
    tokenProgram,      // 𐄂 writable, 𐄂 signer
  })
  .signers([authorityKey])
  .rpc();

Close Admin

Close a MarketAccount and the associated VaultAccount.

Account Info

The following 5 account addresses should be provided when invoking this instruction.

Name	Type	Description
`market`		The MarketAccount address.
`vault`		The VaultAccount address.
`user`		The user token account that will debit/credit the tokens.
`authority`		The signing authority of the program invocation.
`tokenProgram`		The official SPL Token Program address. Responsible for token CPIs.

Solana Dispatch ID

The Solana dispatch ID for the Close Admin Instruction
is cab6b98ed0a191bd,
which can also be expressed as an 8 byte discriminator:

[202,182,185,142,208,161,145,189]

Example with Anchor

To invoke the Close Admin Instruction
with Anchor TSopen in new window.

let tx = await program.methods
  .closeAdmin()
  .accounts({
    market,            // ✓ writable, 𐄂 signer
    vault,             // ✓ writable, 𐄂 signer
    user,              // ✓ writable, 𐄂 signer
    authority,         // 𐄂 writable, ✓ signer
    tokenProgram,      // 𐄂 writable, 𐄂 signer
  })
  .signers([authorityKey])
  .rpc();

Assign

Create a JobAccount and optional RunAccount with node assigned.

Account Info

The following 13 account addresses should be provided when invoking this instruction.

Name	Type	Description
`job`		The JobAccount address.
`market`		The MarketAccount address.
`run`		The RunAccount address.
`node`		The node that runs this job.
`user`		The user token account that will debit/credit the tokens.
`vault`		The VaultAccount address.
`payer`		The paying identy for the rent.
`rewardsReflection`		The Nosana Rewards Program's ReflectionAccount address.
`rewardsVault`		The Nosana Rewards Program's VaultAccount address.
`authority`		The signing authority of the program invocation.
`rewardsProgram`		The Nosana Rewards Program address.
`tokenProgram`		The official SPL Token Program address. Responsible for token CPIs.
`systemProgram`		The official Solana system program address. Responsible for system CPIs.

Arguments

The following 2 arguments should also be provided when invoking this instruction.

Name	Type	Size	Offset	Description
`ipfsJob`	`["u8",32]`	`32`	`0`	The byte array representing the IPFS hash to the job.
`timeout`	`i64`	`16`	`32`	The timeout time in seconds for a job.

Solana Dispatch ID

The Solana dispatch ID for the Assign Instruction
is 49427dcb51294087,
which can also be expressed as an 8 byte discriminator:

[73,66,125,203,81,41,64,135]

Example with Anchor

To invoke the Assign Instruction
with Anchor TSopen in new window.

let tx = await program.methods
  .assign(
    ipfsJob,           // type: ["u8",32]
    timeout,           // type: i64
  )
  .accounts({
    job,               // ✓ writable, ✓ signer
    market,            // ✓ writable, 𐄂 signer
    run,               // ✓ writable, ✓ signer
    node,              // 𐄂 writable, 𐄂 signer
    user,              // ✓ writable, 𐄂 signer
    vault,             // ✓ writable, 𐄂 signer
    payer,             // ✓ writable, ✓ signer
    rewardsReflection, // ✓ writable, 𐄂 signer
    rewardsVault,      // ✓ writable, 𐄂 signer
    authority,         // 𐄂 writable, ✓ signer
    rewardsProgram,    // 𐄂 writable, 𐄂 signer
    tokenProgram,      // 𐄂 writable, 𐄂 signer
    systemProgram,     // 𐄂 writable, 𐄂 signer
  })
  .signers([jobKey, runKey, payerKey, authorityKey])
  .rpc();

List

Create a JobAccount and optional RunAccount.

Account Info

The following 12 account addresses should be provided when invoking this instruction.

Name	Type	Description
`job`		The JobAccount address.
`market`		The MarketAccount address.
`run`		The RunAccount address.
`user`		The user token account that will debit/credit the tokens.
`vault`		The VaultAccount address.
`payer`		The paying identy for the rent.
`rewardsReflection`		The Nosana Rewards Program's ReflectionAccount address.
`rewardsVault`		The Nosana Rewards Program's VaultAccount address.
`authority`		The signing authority of the program invocation.
`rewardsProgram`		The Nosana Rewards Program address.
`tokenProgram`		The official SPL Token Program address. Responsible for token CPIs.
`systemProgram`		The official Solana system program address. Responsible for system CPIs.

Arguments

The following 2 arguments should also be provided when invoking this instruction.

Name	Type	Size	Offset	Description
`ipfsJob`	`["u8",32]`	`32`	`0`	The byte array representing the IPFS hash to the job.
`timeout`	`i64`	`16`	`32`	The timeout time in seconds for a job.

Solana Dispatch ID

The Solana dispatch ID for the List Instruction
is 36aec14311298426,
which can also be expressed as an 8 byte discriminator:

[54,174,193,67,17,41,132,38]

Example with Anchor

To invoke the List Instruction
with Anchor TSopen in new window.

let tx = await program.methods
  .list(
    ipfsJob,           // type: ["u8",32]
    timeout,           // type: i64
  )
  .accounts({
    job,               // ✓ writable, ✓ signer
    market,            // ✓ writable, 𐄂 signer
    run,               // ✓ writable, ✓ signer
    user,              // ✓ writable, 𐄂 signer
    vault,             // ✓ writable, 𐄂 signer
    payer,             // ✓ writable, ✓ signer
    rewardsReflection, // ✓ writable, 𐄂 signer
    rewardsVault,      // ✓ writable, 𐄂 signer
    authority,         // 𐄂 writable, ✓ signer
    rewardsProgram,    // 𐄂 writable, 𐄂 signer
    tokenProgram,      // 𐄂 writable, 𐄂 signer
    systemProgram,     // 𐄂 writable, 𐄂 signer
  })
  .signers([jobKey, runKey, payerKey, authorityKey])
  .rpc();

Delist

Remove a JobAccount from market job queue.

Account Info

The following 7 account addresses should be provided when invoking this instruction.

Name	Type	Description
`job`		The JobAccount address.
`market`		The MarketAccount address.
`deposit`		n/a
`payer`		The paying identy for the rent.
`vault`		The VaultAccount address.
`tokenProgram`		The official SPL Token Program address. Responsible for token CPIs.
`authority`		The signing authority of the program invocation.

Solana Dispatch ID

The Solana dispatch ID for the Delist Instruction
is 3788cd6b6bad041f,
which can also be expressed as an 8 byte discriminator:

[55,136,205,107,107,173,4,31]

Example with Anchor

To invoke the Delist Instruction
with Anchor TSopen in new window.

let tx = await program.methods
  .delist()
  .accounts({
    job,               // ✓ writable, 𐄂 signer
    market,            // ✓ writable, 𐄂 signer
    deposit,           // ✓ writable, 𐄂 signer
    payer,             // ✓ writable, 𐄂 signer
    vault,             // ✓ writable, 𐄂 signer
    tokenProgram,      // 𐄂 writable, 𐄂 signer
    authority,         // ✓ writable, ✓ signer
  })
  .signers([authorityKey])
  .rpc();

Recover

Recover funds from a JobAccount that has been quit.

Account Info

The following 7 account addresses should be provided when invoking this instruction.

Name	Type	Description
`job`		The JobAccount address.
`market`		The MarketAccount address.
`vault`		The VaultAccount address.
`user`		The user token account that will debit/credit the tokens.
`payer`		The paying identy for the rent.
`authority`		The signing authority of the program invocation.
`tokenProgram`		The official SPL Token Program address. Responsible for token CPIs.

Solana Dispatch ID

The Solana dispatch ID for the Recover Instruction
is 6cd8263a6d927411,
which can also be expressed as an 8 byte discriminator:

[108,216,38,58,109,146,116,17]

Example with Anchor

To invoke the Recover Instruction
with Anchor TSopen in new window.

let tx = await program.methods
  .recover()
  .accounts({
    job,               // ✓ writable, 𐄂 signer
    market,            // 𐄂 writable, 𐄂 signer
    vault,             // ✓ writable, 𐄂 signer
    user,              // ✓ writable, 𐄂 signer
    payer,             // ✓ writable, 𐄂 signer
    authority,         // 𐄂 writable, ✓ signer
    tokenProgram,      // 𐄂 writable, 𐄂 signer
  })
  .signers([authorityKey])
  .rpc();

Extend

Extend a job timeout

Account Info

The following 9 account addresses should be provided when invoking this instruction.

Name	Type	Description
`job`		The JobAccount address.
`market`		The MarketAccount address.
`user`		The user token account that will debit/credit the tokens.
`vault`		The VaultAccount address.
`rewardsReflection`		The Nosana Rewards Program's ReflectionAccount address.
`rewardsVault`		The Nosana Rewards Program's VaultAccount address.
`authority`		The signing authority of the program invocation.
`rewardsProgram`		The Nosana Rewards Program address.
`tokenProgram`		The official SPL Token Program address. Responsible for token CPIs.

Arguments

The following 1 arguments should also be provided when invoking this instruction.

Name	Type	Size	Offset	Description
`timeout`	`i64`	`16`	`0`	The timeout time in seconds for a job.

Solana Dispatch ID

The Solana dispatch ID for the Extend Instruction
is e47f0001e39a36a8,
which can also be expressed as an 8 byte discriminator:

[228,127,0,1,227,154,54,168]

Example with Anchor

To invoke the Extend Instruction
with Anchor TSopen in new window.

let tx = await program.methods
  .extend(
    timeout,           // type: i64
  )
  .accounts({
    job,               // ✓ writable, 𐄂 signer
    market,            // 𐄂 writable, 𐄂 signer
    user,              // ✓ writable, 𐄂 signer
    vault,             // ✓ writable, 𐄂 signer
    rewardsReflection, // ✓ writable, 𐄂 signer
    rewardsVault,      // ✓ writable, 𐄂 signer
    authority,         // 𐄂 writable, ✓ signer
    rewardsProgram,    // 𐄂 writable, 𐄂 signer
    tokenProgram,      // 𐄂 writable, 𐄂 signer
  })
  .signers([authorityKey])
  .rpc();

End

End a running JobAccount and close RunAccount.

Account Info

The following 9 account addresses should be provided when invoking this instruction.

Name	Type	Description
`job`		The JobAccount address.
`market`		The MarketAccount address.
`run`		The RunAccount address.
`deposit`		n/a
`user`		The user token account that will debit/credit the tokens.
`vault`		The VaultAccount address.
`payer`		The paying identy for the rent.
`authority`		The signing authority of the program invocation.
`tokenProgram`		The official SPL Token Program address. Responsible for token CPIs.

Solana Dispatch ID

The Solana dispatch ID for the End Instruction
is b4a0f9d9c2794610,
which can also be expressed as an 8 byte discriminator:

[180,160,249,217,194,121,70,16]

Example with Anchor

To invoke the End Instruction
with Anchor TSopen in new window.

let tx = await program.methods
  .end()
  .accounts({
    job,               // ✓ writable, 𐄂 signer
    market,            // 𐄂 writable, 𐄂 signer
    run,               // ✓ writable, 𐄂 signer
    deposit,           // ✓ writable, 𐄂 signer
    user,              // ✓ writable, 𐄂 signer
    vault,             // ✓ writable, 𐄂 signer
    payer,             // ✓ writable, 𐄂 signer
    authority,         // ✓ writable, ✓ signer
    tokenProgram,      // 𐄂 writable, 𐄂 signer
  })
  .signers([authorityKey])
  .rpc();

Work

Enters the MarketAccount queue, or create a RunAccount.

Account Info

The following 8 account addresses should be provided when invoking this instruction.

Name	Type	Description
`run`		The RunAccount address.
`market`		The MarketAccount address.
`payer`		The paying identy for the rent.
`stake`		The StakeAccount address.
`nft`		The Token Account address that holds the NFT.
`metadata`		The Metaplex Metadata address, that belongs to the NFT.
`authority`		The signing authority of the program invocation.
`systemProgram`		The official Solana system program address. Responsible for system CPIs.

Solana Dispatch ID

The Solana dispatch ID for the Work Instruction
is 0f432dc3d789e52f,
which can also be expressed as an 8 byte discriminator:

[15,67,45,195,215,137,229,47]

Example with Anchor

To invoke the Work Instruction
with Anchor TSopen in new window.

let tx = await program.methods
  .work()
  .accounts({
    run,               // ✓ writable, ✓ signer
    market,            // ✓ writable, 𐄂 signer
    payer,             // ✓ writable, ✓ signer
    stake,             // 𐄂 writable, 𐄂 signer
    nft,               // 𐄂 writable, 𐄂 signer
    metadata,          // 𐄂 writable, 𐄂 signer
    authority,         // 𐄂 writable, ✓ signer
    systemProgram,     // 𐄂 writable, 𐄂 signer
  })
  .signers([runKey, payerKey, authorityKey])
  .rpc();

Stop

Exit the node queue from MarketAccount.

Account Info

The following 3 account addresses should be provided when invoking this instruction.

Name	Type	Description
`market`		The MarketAccount address.
`node`		The node that runs this job.
`authority`		The signing authority of the program invocation.

Solana Dispatch ID

The Solana dispatch ID for the Stop Instruction
is 2a85203cabfdb89b,
which can also be expressed as an 8 byte discriminator:

[42,133,32,60,171,253,184,155]

Example with Anchor

To invoke the Stop Instruction
with Anchor TSopen in new window.

let tx = await program.methods
  .stop()
  .accounts({
    market,            // ✓ writable, 𐄂 signer
    node,              // 𐄂 writable, 𐄂 signer
    authority,         // 𐄂 writable, ✓ signer
  })
  .signers([authorityKey])
  .rpc();

Claim

Claim a job that is stopped.

Account Info

The following 9 account addresses should be provided when invoking this instruction.

Name	Type	Description
`job`		The JobAccount address.
`run`		The RunAccount address.
`market`		The MarketAccount address.
`stake`		The StakeAccount address.
`nft`		The Token Account address that holds the NFT.
`metadata`		The Metaplex Metadata address, that belongs to the NFT.
`payer`		The paying identy for the rent.
`authority`		The signing authority of the program invocation.
`systemProgram`		The official Solana system program address. Responsible for system CPIs.

Solana Dispatch ID

The Solana dispatch ID for the Claim Instruction
is 3ec6d6c1d59f6cd2,
which can also be expressed as an 8 byte discriminator:

[62,198,214,193,213,159,108,210]

Example with Anchor

To invoke the Claim Instruction
with Anchor TSopen in new window.

let tx = await program.methods
  .claim()
  .accounts({
    job,               // ✓ writable, 𐄂 signer
    run,               // ✓ writable, ✓ signer
    market,            // 𐄂 writable, 𐄂 signer
    stake,             // 𐄂 writable, 𐄂 signer
    nft,               // 𐄂 writable, 𐄂 signer
    metadata,          // 𐄂 writable, 𐄂 signer
    payer,             // ✓ writable, ✓ signer
    authority,         // 𐄂 writable, ✓ signer
    systemProgram,     // 𐄂 writable, 𐄂 signer
  })
  .signers([runKey, payerKey, authorityKey])
  .rpc();

Complete

Complete a job that has been stopped.

Account Info

The following 2 account addresses should be provided when invoking this instruction.

Name	Type	Description
`job`		The JobAccount address.
`authority`		The signing authority of the program invocation.

Arguments

The following 1 arguments should also be provided when invoking this instruction.

Name	Type	Size	Offset	Description
`ipfsResult`	`["u8",32]`	`32`	`0`	The byte array representing the IPFS hash to the results.

Solana Dispatch ID

The Solana dispatch ID for the Complete Instruction
is 004de0938819584c,
which can also be expressed as an 8 byte discriminator:

[0,77,224,147,136,25,88,76]

Example with Anchor

To invoke the Complete Instruction
with Anchor TSopen in new window.

let tx = await program.methods
  .complete(
    ipfsResult,        // type: ["u8",32]
  )
  .accounts({
    job,               // ✓ writable, 𐄂 signer
    authority,         // 𐄂 writable, ✓ signer
  })
  .signers([authorityKey])
  .rpc();

Finish

Post the result for a JobAccount to finish it and get paid.

Account Info

The following 10 account addresses should be provided when invoking this instruction.

Name	Type	Description
`job`		The JobAccount address.
`run`		The RunAccount address.
`market`		The MarketAccount address.
`vault`		The VaultAccount address.
`deposit`		n/a
`user`		The user token account that will debit/credit the tokens.
`payer`		The paying identy for the rent.
`project`		The project that listed this job.
`authority`		The signing authority of the program invocation.
`tokenProgram`		The official SPL Token Program address. Responsible for token CPIs.

Arguments

The following 1 arguments should also be provided when invoking this instruction.

Name	Type	Size	Offset	Description
`ipfsResult`	`["u8",32]`	`32`	`0`	The byte array representing the IPFS hash to the results.

Solana Dispatch ID

The Solana dispatch ID for the Finish Instruction
is 434aaa847de9b625,
which can also be expressed as an 8 byte discriminator:

[67,74,170,132,125,233,182,37]

Example with Anchor

To invoke the Finish Instruction
with Anchor TSopen in new window.

let tx = await program.methods
  .finish(
    ipfsResult,        // type: ["u8",32]
  )
  .accounts({
    job,               // ✓ writable, 𐄂 signer
    run,               // ✓ writable, 𐄂 signer
    market,            // 𐄂 writable, 𐄂 signer
    vault,             // ✓ writable, 𐄂 signer
    deposit,           // ✓ writable, 𐄂 signer
    user,              // ✓ writable, 𐄂 signer
    payer,             // ✓ writable, 𐄂 signer
    project,           // ✓ writable, 𐄂 signer
    authority,         // 𐄂 writable, ✓ signer
    tokenProgram,      // 𐄂 writable, 𐄂 signer
  })
  .signers([authorityKey])
  .rpc();

Quit

Quit a JobAccount that you have started.

Account Info

The following 4 account addresses should be provided when invoking this instruction.

Name	Type	Description
`job`		The JobAccount address.
`run`		The RunAccount address.
`payer`		The paying identy for the rent.
`authority`		The signing authority of the program invocation.

Solana Dispatch ID

The Solana dispatch ID for the Quit Instruction
is bf678df050816799,
which can also be expressed as an 8 byte discriminator:

[191,103,141,240,80,129,103,153]

Example with Anchor

To invoke the Quit Instruction
with Anchor TSopen in new window.

let tx = await program.methods
  .quit()
  .accounts({
    job,               // ✓ writable, 𐄂 signer
    run,               // ✓ writable, 𐄂 signer
    payer,             // ✓ writable, 𐄂 signer
    authority,         // 𐄂 writable, ✓ signer
  })
  .signers([authorityKey])
  .rpc();

Quit Admin

Quit a JobAccount that you have started.

Account Info

The following 3 account addresses should be provided when invoking this instruction.

Name	Type	Description
`run`		The RunAccount address.
`payer`		The paying identy for the rent.
`authority`		The signing authority of the program invocation.

Solana Dispatch ID

The Solana dispatch ID for the Quit Admin Instruction
is 67ee6e08b61438c4,
which can also be expressed as an 8 byte discriminator:

[103,238,110,8,182,20,56,196]

Example with Anchor

To invoke the Quit Admin Instruction
with Anchor TSopen in new window.

let tx = await program.methods
  .quitAdmin()
  .accounts({
    run,               // ✓ writable, 𐄂 signer
    payer,             // ✓ writable, 𐄂 signer
    authority,         // 𐄂 writable, ✓ signer
  })
  .signers([authorityKey])
  .rpc();

Clean

Close an JobAccount.

Account Info

The following 3 account addresses should be provided when invoking this instruction.

Name	Type	Description
`job`		The JobAccount address.
`market`		The MarketAccount address.
`payer`		The paying identy for the rent.

Solana Dispatch ID

The Solana dispatch ID for the Clean Instruction
is fabf388096fb0167,
which can also be expressed as an 8 byte discriminator:

[250,191,56,128,150,251,1,103]

Example with Anchor

To invoke the Clean Instruction
with Anchor TSopen in new window.

let tx = await program.methods
  .clean()
  .accounts({
    job,               // ✓ writable, 𐄂 signer
    market,            // 𐄂 writable, 𐄂 signer
    payer,             // ✓ writable, 𐄂 signer
  })
  .rpc();

Clean Admin

Close an JobAccount as an admin.

Account Info

The following 3 account addresses should be provided when invoking this instruction.

Name	Type	Description
`job`		The JobAccount address.
`payer`		The paying identy for the rent.
`authority`		The signing authority of the program invocation.

Solana Dispatch ID

The Solana dispatch ID for the Clean Admin Instruction
is f55abc44fdebab69,
which can also be expressed as an 8 byte discriminator:

[245,90,188,68,253,235,171,105]

Example with Anchor

To invoke the Clean Admin Instruction
with Anchor TSopen in new window.

let tx = await program.methods
  .cleanAdmin()
  .accounts({
    job,               // ✓ writable, 𐄂 signer
    payer,             // ✓ writable, 𐄂 signer
    authority,         // 𐄂 writable, ✓ signer
  })
  .signers([authorityKey])
  .rpc();

Accounts

A number of 4 accounts make up for the Nosana Jobs Program's state.

Market Account

The MarketAccount struct holds all the information about jobs and the nodes queue.
The total size of this account is 10,211 bytes.

Name	Type	Size	Offset	Description
`authority`	`publicKey`	`32`	`8`	The signing authority of the program invocation.
`jobExpiration`	`i64`	`16`	`40`	The expiration time in seconds for jobs.
`jobPrice`	`u64`	`8`	`56`	The price for jobs in this market.
`jobTimeout`	`i64`	`16`	`64`	The timeout time in seconds for jobs.
`jobType`	`u8`	`1`	`80`	The JobType number.
`vault`	`publicKey`	`32`	`81`	The VaultAccount address.
`vaultBump`	`u8`	`1`	`113`	The bump for the VaultAccount.
`nodeAccessKey`	`publicKey`	`32`	`114`	The NFT collection address of an NFT that the node holds, in order to access this market.
`nodeXnosMinimum`	`u128`	`16`	`146`	The amount of `xNOS` a node needs to qualify for a market.
`queueType`	`u8`	`1`	`162`	The QueueType of the queue. Either Nodes or Jobs.
`queue`	`Vec<publicKey>`	`10048`	`163`	The queue of order in the market.

Anchor Account Discriminator

The first 8 bytes, also known as Anchor's 8 byte discriminator, for the Market Account
are c94ebbe1f0c6c9fb, which can also be expressed in byte array:

[201,78,187,225,240,198,201,251]

Job Account

The JobAccount struct holds all the information about any individual jobs.
The total size of this account is 257 bytes.

Name	Type	Size	Offset	Description
`ipfsJob`	`["u8",32]`	`32`	`8`	The byte array representing the IPFS hash to the job.
`ipfsResult`	`["u8",32]`	`32`	`40`	The byte array representing the IPFS hash to the results.
`market`	`publicKey`	`32`	`72`	The MarketAccount address.
`node`	`publicKey`	`32`	`104`	The node that runs this job.
`payer`	`publicKey`	`32`	`136`	The paying identy for the rent.
`price`	`u64`	`8`	`168`	The price in $NOS.
`project`	`publicKey`	`32`	`176`	The project that listed this job.
`state`	`u8`	`1`	`208`	n/a
`timeEnd`	`i64`	`16`	`209`	The unix time this job has finished running.
`timeStart`	`i64`	`16`	`225`	The unix time this job has started running.
`timeout`	`i64`	`16`	`241`	The timeout time in seconds for a job.

Anchor Account Discriminator

The first 8 bytes, also known as Anchor's 8 byte discriminator, for the Job Account
are 5b10a2052dd27d41, which can also be expressed in byte array:

[91,16,162,5,45,210,125,65]

Run Account

The RunAccount struct holds temporary information that matches nodes to jobs.
The total size of this account is 121 bytes.

Name	Type	Size	Offset	Description
`job`	`publicKey`	`32`	`8`	The JobAccount address.
`node`	`publicKey`	`32`	`40`	The node that runs this job.
`payer`	`publicKey`	`32`	`72`	The paying identy for the rent.
`state`	`u8`	`1`	`104`	n/a
`time`	`i64`	`16`	`105`	n/a

Anchor Account Discriminator

The first 8 bytes, also known as Anchor's 8 byte discriminator, for the Run Account
are c2a96ee6eb0be116, which can also be expressed in byte array:

[194,169,110,230,235,11,225,22]

Vault Account

The VaultAccount is a regular Solana Token Account.

Types

A number of 3 type variants are defined in the Nosana Jobs Program's state.

Queue Type

The QueueType describes the type of queue

A number of 3 variants are defined in this enum:

Name	Number
`Job`	`0`
`Node`	`1`
`Empty`	`2`

Job State

The JobState describes the status of a job.

A number of 3 variants are defined in this enum:

Name	Number
`Queued`	`0`
`Done`	`1`
`Stopped`	`2`

Job Type

The JobType describes the type of any job.

A number of 6 variants are defined in this enum:

Name	Number
`Default`	`0`
`Small`	`1`
`Medium`	`2`
`Large`	`3`
`Gpu`	`4`
`Unknown`	`255`

Errors

A number of 19 errors are defined in the Nosana Jobs Program.

6000

Nosana Error

`6000` - Invalid Market Account

This market account is not valid.

6001

Nosana Error

`6001` - Market In Wrong State

This market does not have the right status.

6002

Nosana Error

`6002` - Not In Market Queue

Account cannot be find account in market queue.

6003

Nosana Error

`6003` - Invalid Job Account

This job account is not valid.

6004

Nosana Error

`6004` - Job In Wrong State

This job does not have the right status.

6005

Nosana Error

`6005` - Job Not Expired

The job has not yet expired.

6006

Nosana Error

`6006` - Job Result Null

The job result can not be null.

6007

Nosana Error

`6007` - Job Invalid Project

The job has a different project owner.

6008

Nosana Error

`6008` - Job Timeout Not Greater

The new job timeout should be larger than the current one.

6009

Nosana Error

`6009` - Job Invalid Run Account

The run account does not match the job.

6010

Nosana Error

`6010` - Job Results Already Set

The job results are already set.

6011

Nosana Error

`6011` - Node Queue Does Not Match

This node queue does not match.

6012

Nosana Error

`6012` - Node Stake Unauthorized

This node is not authorizing this stake.

6013

Nosana Error

`6013` - Node Not Enough Stake

This node has not staked enough tokens.

6014

Nosana Error

`6014` - Node Already Queued

This node is already present in the queue.

6015

Nosana Error

`6015` - Node Nft Wrong Metadata

This metadata does not have the correct address.

6016

Nosana Error

`6016` - Node Nft Wrong Owner

This NFT is not owned by this node.

6017

Nosana Error

`6017` - Node Nft Invalid Amount

Access NFT amount cannot be 0.

6018

Nosana Error

`6018` - Node Key Invalid Collection

This access key does not belong to a verified collection.

Diagram

Instruction Diagram

Queue Diagrams

Below a representation of the functioning for the different QueueTypes.

Node Queue

Node

When there a more nodes than jobs in a given Market, the queue will fill up with nodes.
The QueueType will be Node in this case.

Job Queue

Vise versa, When there a more jobs than nodes in a given Market, the queue will fill up with jobs.
The QueueType will be Job in this case.

Empty Queue

Finally, at the point when the market is satisfied, the queue will be empty.
The QueueType will be Unknown in this case.

Nosana Jobs

# Nosana Jobs

# Program Information

# Instructions

# Open

# Account Info

# Arguments

# Update

# Account Info

# Arguments

# Close

# Account Info

# Close Admin

# Account Info

# Assign

# Account Info

# Arguments

# List

# Account Info

# Arguments

# Delist

# Account Info

# Recover

# Account Info

# Extend

# Account Info

# Arguments

# End

# Account Info

# Work

# Account Info

# Stop

# Account Info

# Claim

# Account Info

# Complete

# Account Info

# Arguments

# Finish

# Account Info

# Arguments

# Quit

# Account Info

# Quit Admin

# Account Info

# Clean

# Account Info

# Clean Admin

# Account Info

# Accounts

# Market Account

# Job Account

# Run Account

# Vault Account

# Types

# Queue Type

# Job State

# Job Type

# Errors

# 6000 - Invalid Market Account

# 6001 - Market In Wrong State

# 6002 - Not In Market Queue

# 6003 - Invalid Job Account

# 6004 - Job In Wrong State

# 6005 - Job Not Expired

# 6006 - Job Result Null

# 6007 - Job Invalid Project

# 6008 - Job Timeout Not Greater

# 6009 - Job Invalid Run Account

# 6010 - Job Results Already Set

# 6011 - Node Queue Does Not Match

# 6012 - Node Stake Unauthorized

# 6013 - Node Not Enough Stake

# 6014 - Node Already Queued

# 6015 - Node Nft Wrong Metadata

# 6016 - Node Nft Wrong Owner

# 6017 - Node Nft Invalid Amount

# 6018 - Node Key Invalid Collection

# Diagram

# Instruction Diagram

Nosana Jobs

Program Information

Instructions

Open

Account Info

Arguments

Update

Account Info

Arguments

Close

Account Info

Close Admin

Account Info

Assign

Account Info

Arguments

List

Account Info

Arguments

Delist

Account Info

Recover

Account Info

Extend

Account Info

Arguments

End

Account Info

Work

Account Info

Stop

Account Info

Claim

Account Info

Complete

Account Info

Arguments

Finish

Account Info

Arguments

Quit

Account Info

Quit Admin

Account Info

Clean

Account Info

Clean Admin

Account Info

Accounts

Market Account

Job Account

Run Account

Vault Account

Types

Queue Type

Job State

Job Type

Errors

`6000` - Invalid Market Account

`6001` - Market In Wrong State

`6002` - Not In Market Queue

`6003` - Invalid Job Account

`6004` - Job In Wrong State

`6005` - Job Not Expired

`6006` - Job Result Null

`6007` - Job Invalid Project

`6008` - Job Timeout Not Greater

`6009` - Job Invalid Run Account

`6010` - Job Results Already Set

`6011` - Node Queue Does Not Match

`6012` - Node Stake Unauthorized

`6013` - Node Not Enough Stake

`6014` - Node Already Queued

`6015` - Node Nft Wrong Metadata

`6016` - Node Nft Wrong Owner

`6017` - Node Nft Invalid Amount

`6018` - Node Key Invalid Collection

Diagram

Instruction Diagram

Queue Diagrams