genlayer 0.38.8 → 0.38.10

package/docs/api-references/localnet/_meta.json

@@ -0,0 +1,3 @@
+{
+  "localnet": "localnet"
+}

package/docs/api-references/localnet/localnet/validators/count.mdx

@@ -0,0 +1,15 @@
+---
+title: localnet validators count
+---
+
+Count all validators
+
+### Usage
+
+`$ genlayer localnet validators count [options]`
+
+### Options
+
+| Short | Long | Description | Required | Default |
+| --- | --- | --- | :---: | --- |
+| -h | --help | display help for command | No |  |

package/docs/api-references/localnet/localnet/validators/create-random.mdx

@@ -0,0 +1,16 @@
+---
+title: localnet validators create-random
+---
+
+Create random validators
+
+### Usage
+
+`$ genlayer localnet validators create-random [options]`
+
+### Options
+
+| Short | Long | Description | Required | Default |
+| --- | --- | --- | :---: | --- |
+|  | --count <count> | Number of validators to create openai ollama) gpt-4o) | No | `[]` |
+| -h | --help | display help for command | No |  |

package/docs/api-references/localnet/localnet/validators/create.mdx

@@ -0,0 +1,19 @@
+---
+title: localnet validators create
+---
+
+Create a new validator
+
+### Usage
+
+`$ genlayer localnet validators create [options]`
+
+### Options
+
+| Short | Long | Description | Required | Default |
+| --- | --- | --- | :---: | --- |
+|  | --stake <stake> | Stake amount for the validator (default: 1) (default: "1") | No |  |
+|  | --config <config> | Optional JSON configuration for the validator (e.g., '\{"max_tokens": 500, "temperature": 0.75\}') | No |  |
+|  | --provider <provider> | Specify the provider for the validator | No |  |
+|  | --model <model> | Specify the model for the validator | No |  |
+| -h | --help | display help for command | No |  |

package/docs/api-references/localnet/localnet/validators/delete.mdx

@@ -0,0 +1,16 @@
+---
+title: localnet validators delete
+---
+
+Delete a specific validator or all validators
+
+### Usage
+
+`$ genlayer localnet validators delete [options]`
+
+### Options
+
+| Short | Long | Description | Required | Default |
+| --- | --- | --- | :---: | --- |
+|  | --address <validatorAddress> | The address of the validator to delete (omit to delete all validators) | No |  |
+| -h | --help | display help for command | No |  |

package/docs/api-references/localnet/localnet/validators/get.mdx

@@ -0,0 +1,16 @@
+---
+title: localnet validators get
+---
+
+Retrieve details of a specific validator or all validators
+
+### Usage
+
+`$ genlayer localnet validators get [options]`
+
+### Options
+
+| Short | Long | Description | Required | Default |
+| --- | --- | --- | :---: | --- |
+|  | --address <validatorAddress> | The address of the validator to retrieve (omit to retrieve all validators) | No |  |
+| -h | --help | display help for command | No |  |

package/docs/api-references/localnet/localnet/validators/update.mdx

@@ -0,0 +1,23 @@
+---
+title: localnet validators update
+---
+
+Update a validator's details
+
+### Usage
+
+`$ genlayer localnet validators update [options] <validatorAddress>`
+
+### Arguments
+
+- `<validatorAddress>`
+
+### Options
+
+| Short | Long | Description | Required | Default |
+| --- | --- | --- | :---: | --- |
+|  | --stake &lt;stake&gt; | New stake for the validator | No |  |
+|  | --provider &lt;provider&gt; | New provider for the validator | No |  |
+|  | --model &lt;model&gt; | New model for the validator | No |  |
+|  | --config &lt;config&gt; | New JSON config for the validator | No |  |
+| -h | --help | display help for command | No |  |

package/docs/api-references/localnet/localnet/validators.mdx

@@ -0,0 +1,28 @@
+---
+title: localnet validators
+---
+
+Manage localnet validators operations
+
+### Usage
+
+`$ genlayer localnet validators [options] [command]`
+
+### Arguments
+
+- `[command]`
+
+### Options
+
+| Short | Long | Description | Required | Default |
+| --- | --- | --- | :---: | --- |
+| -h | --help | display help for command | No |  |
+
+### Subcommands
+
+- `genlayer get` — Retrieve details of a specific validator
+- `genlayer delete` — Delete a specific validator or all
+- `genlayer count` — Count all validators
+- `genlayer update` — Update a validator's details
+- `genlayer create-random` — Create random validators
+- `genlayer create` — Create a new validator

package/docs/api-references/localnet/localnet.mdx

@@ -0,0 +1,23 @@
+---
+title: localnet
+---
+
+Manage localnet operations
+
+### Usage
+
+`$ genlayer localnet [options] [command]`
+
+### Arguments
+
+- `[command]`
+
+### Options
+
+| Short | Long | Description | Required | Default |
+| --- | --- | --- | :---: | --- |
+| -h | --help | display help for command | No |  |
+
+### Subcommands
+
+- `genlayer validators` — Manage localnet validators operations

package/docs/api-references/staking/_meta.json

@@ -0,0 +1,3 @@
+{
+  "staking": "staking"
+}

package/docs/api-references/staking/staking/active-validators.mdx

@@ -0,0 +1,18 @@
+---
+title: staking active-validators
+---
+
+List all active validators
+
+### Usage
+
+`$ genlayer staking active-validators [options]`
+
+### Options
+
+| Short | Long | Description | Required | Default |
+| --- | --- | --- | :---: | --- |
+|  | --network <network> | Network to use (localnet, testnet-asimov) | No |  |
+|  | --rpc <rpcUrl> | RPC URL for the network | No |  |
+|  | --staking-address <address> | Staking contract address (overrides chain config) | No |  |
+| -h | --help | display help for command | No |  |

package/docs/api-references/staking/staking/banned-validators.mdx

@@ -0,0 +1,18 @@
+---
+title: staking banned-validators
+---
+
+List all banned validators
+
+### Usage
+
+`$ genlayer staking banned-validators [options]`
+
+### Options
+
+| Short | Long | Description | Required | Default |
+| --- | --- | --- | :---: | --- |
+|  | --network <network> | Network to use (localnet, testnet-asimov) | No |  |
+|  | --rpc <rpcUrl> | RPC URL for the network | No |  |
+|  | --staking-address <address> | Staking contract address (overrides chain config) | No |  |
+| -h | --help | display help for command | No |  |

package/docs/api-references/staking/staking/delegation-info.mdx

@@ -0,0 +1,25 @@
+---
+title: staking delegation-info
+---
+
+Get delegation info for a delegator with a validator
+
+### Usage
+
+`$ genlayer staking delegation-info [options] [validator]`
+
+### Arguments
+
+- `[validator]`
+
+### Options
+
+| Short | Long | Description | Required | Default |
+| --- | --- | --- | :---: | --- |
+|  | --validator <address> | Validator address (deprecated, use positional arg) | No |  |
+|  | --delegator <address> | Delegator address (defaults to signer) | No |  |
+|  | --account <name> | Account to use (for default delegator address) | No |  |
+|  | --network <network> | Network to use (localnet, testnet-asimov) | No |  |
+|  | --rpc <rpcUrl> | RPC URL for the network | No |  |
+|  | --staking-address <address> | Staking contract address (overrides chain config) | No |  |
+| -h | --help | display help for command | No |  |

package/docs/api-references/staking/staking/delegator-claim.mdx

@@ -0,0 +1,26 @@
+---
+title: staking delegator-claim
+---
+
+Claim delegator withdrawals after unbonding period
+
+### Usage
+
+`$ genlayer staking delegator-claim [options] [validator]`
+
+### Arguments
+
+- `[validator]`
+
+### Options
+
+| Short | Long | Description | Required | Default |
+| --- | --- | --- | :---: | --- |
+|  | --validator <address> | Validator address (deprecated, use positional arg) | No |  |
+|  | --delegator <address> | Delegator address (defaults to signer) | No |  |
+|  | --account <name> | Account to use | No |  |
+|  | --password <password> | Password to unlock account (skips interactive prompt) | No |  |
+|  | --network <network> | Network to use (localnet, testnet-asimov) | No |  |
+|  | --rpc <rpcUrl> | RPC URL for the network | No |  |
+|  | --staking-address <address> | Staking contract address (overrides chain config) | No |  |
+| -h | --help | display help for command | No |  |

package/docs/api-references/staking/staking/delegator-exit.mdx

@@ -0,0 +1,26 @@
+---
+title: staking delegator-exit
+---
+
+Exit as a delegator by withdrawing shares from a validator
+
+### Usage
+
+`$ genlayer staking delegator-exit [options] [validator]`
+
+### Arguments
+
+- `[validator]`
+
+### Options
+
+| Short | Long | Description | Required | Default |
+| --- | --- | --- | :---: | --- |
+|  | --validator <address> | Validator address to exit from (deprecated, use positional arg) | No |  |
+|  | --shares <shares> | Number of shares to withdraw | No |  |
+|  | --account <name> | Account to use | No |  |
+|  | --password <password> | Password to unlock account (skips interactive prompt) | No |  |
+|  | --network <network> | Network to use (localnet, testnet-asimov) | No |  |
+|  | --rpc <rpcUrl> | RPC URL for the network | No |  |
+|  | --staking-address <address> | Staking contract address (overrides chain config) | No |  |
+| -h | --help | display help for command | No |  |

package/docs/api-references/staking/staking/delegator-join.mdx

@@ -0,0 +1,26 @@
+---
+title: staking delegator-join
+---
+
+Join as a delegator by staking with a validator
+
+### Usage
+
+`$ genlayer staking delegator-join [options] [validator]`
+
+### Arguments
+
+- `[validator]`
+
+### Options
+
+| Short | Long | Description | Required | Default |
+| --- | --- | --- | :---: | --- |
+|  | --validator <address> | Validator address to delegate to (deprecated, use positional arg) | No |  |
+|  | --amount <amount> | Amount to stake (in wei or with 'eth'/'gen' suffix) | No |  |
+|  | --account <name> | Account to use | No |  |
+|  | --password <password> | Password to unlock account (skips interactive prompt) | No |  |
+|  | --network <network> | Network to use (localnet, testnet-asimov) | No |  |
+|  | --rpc <rpcUrl> | RPC URL for the network | No |  |
+|  | --staking-address <address> | Staking contract address (overrides chain config) | No |  |
+| -h | --help | display help for command | No |  |

package/docs/api-references/staking/staking/epoch-info.mdx

@@ -0,0 +1,19 @@
+---
+title: staking epoch-info
+---
+
+Get current epoch and staking parameters
+
+### Usage
+
+`$ genlayer staking epoch-info [options]`
+
+### Options
+
+| Short | Long | Description | Required | Default |
+| --- | --- | --- | :---: | --- |
+|  | --epoch <number> | Show data for specific epoch (current or previous only) | No |  |
+|  | --network <network> | Network to use (localnet, testnet-asimov) | No |  |
+|  | --rpc <rpcUrl> | RPC URL for the network | No |  |
+|  | --staking-address <address> | Staking contract address (overrides chain config) | No |  |
+| -h | --help | display help for command | No |  |

package/docs/api-references/staking/staking/prime-all.mdx

@@ -0,0 +1,20 @@
+---
+title: staking prime-all
+---
+
+Prime all validators that need priming
+
+### Usage
+
+`$ genlayer staking prime-all [options]`
+
+### Options
+
+| Short | Long | Description | Required | Default |
+| --- | --- | --- | :---: | --- |
+|  | --account <name> | Account to use (pays gas) | No |  |
+|  | --password <password> | Password to unlock account (skips interactive prompt) | No |  |
+|  | --network <network> | Network to use (localnet, testnet-asimov) | No |  |
+|  | --rpc <rpcUrl> | RPC URL for the network | No |  |
+|  | --staking-address <address> | Staking contract address (overrides chain config) | No |  |
+| -h | --help | display help for command | No |  |

package/docs/api-references/staking/staking/quarantined-validators.mdx

@@ -0,0 +1,18 @@
+---
+title: staking quarantined-validators
+---
+
+List all quarantined validators
+
+### Usage
+
+`$ genlayer staking quarantined-validators [options]`
+
+### Options
+
+| Short | Long | Description | Required | Default |
+| --- | --- | --- | :---: | --- |
+|  | --network <network> | Network to use (localnet, testnet-asimov) | No |  |
+|  | --rpc <rpcUrl> | RPC URL for the network | No |  |
+|  | --staking-address <address> | Staking contract address (overrides chain config) | No |  |
+| -h | --help | display help for command | No |  |

package/docs/api-references/staking/staking/set-identity.mdx

@@ -0,0 +1,33 @@
+---
+title: staking set-identity
+---
+
+Set validator identity metadata (moniker, website, socials, etc.)
+
+### Usage
+
+`$ genlayer staking set-identity [options] [validator]`
+
+### Arguments
+
+- `[validator]`
+
+### Options
+
+| Short | Long | Description | Required | Default |
+| --- | --- | --- | :---: | --- |
+|  | --validator <address> | Validator wallet address (deprecated, use positional arg) | No |  |
+|  | --moniker <name> | Validator display name | No |  |
+|  | --logo-uri <uri> | Logo URI | No |  |
+|  | --website <url> | Website URL | No |  |
+|  | --description <text> | Description | No |  |
+|  | --email <email> | Contact email | No |  |
+|  | --twitter <handle> | Twitter handle | No |  |
+|  | --telegram <handle> | Telegram handle | No |  |
+|  | --github <handle> | GitHub handle | No |  |
+|  | --extra-cid <cid> | Extra data as IPFS CID or hex bytes (0x...) | No |  |
+|  | --account <name> | Account to use (must be validator operator) | No |  |
+|  | --password <password> | Password to unlock account (skips interactive prompt) | No |  |
+|  | --network <network> | Network to use (localnet, testnet-asimov) | No |  |
+|  | --rpc <rpcUrl> | RPC URL for the network | No |  |
+| -h | --help | display help for command | No |  |

package/docs/api-references/staking/staking/set-operator.mdx

@@ -0,0 +1,26 @@
+---
+title: staking set-operator
+---
+
+Change the operator address for a validator wallet
+
+### Usage
+
+`$ genlayer staking set-operator [options] [validator] [operator]`
+
+### Arguments
+
+- `[validator]`
+- `[operator]`
+
+### Options
+
+| Short | Long | Description | Required | Default |
+| --- | --- | --- | :---: | --- |
+|  | --validator <address> | Validator wallet address (deprecated, use positional arg) | No |  |
+|  | --operator <address> | New operator address (deprecated, use positional arg) | No |  |
+|  | --account <name> | Account to use (must be validator owner) | No |  |
+|  | --password <password> | Password to unlock account (skips interactive prompt) | No |  |
+|  | --network <network> | Network to use (localnet, testnet-asimov) | No |  |
+|  | --rpc <rpcUrl> | RPC URL for the network | No |  |
+| -h | --help | display help for command | No |  |

package/docs/api-references/staking/staking/validator-claim.mdx

@@ -0,0 +1,24 @@
+---
+title: staking validator-claim
+---
+
+Claim validator withdrawals after unbonding period
+
+### Usage
+
+`$ genlayer staking validator-claim [options] [validator]`
+
+### Arguments
+
+- `[validator]`
+
+### Options
+
+| Short | Long | Description | Required | Default |
+| --- | --- | --- | :---: | --- |
+|  | --validator <address> | Validator wallet contract address (deprecated, use positional arg) | No |  |
+|  | --account <name> | Account to use | No |  |
+|  | --password <password> | Password to unlock account (skips interactive prompt) | No |  |
+|  | --network <network> | Network to use (localnet, testnet-asimov) | No |  |
+|  | --rpc <rpcUrl> | RPC URL for the network | No |  |
+| -h | --help | display help for command | No |  |

package/docs/api-references/staking/staking/validator-deposit.mdx

@@ -0,0 +1,25 @@
+---
+title: staking validator-deposit
+---
+
+Make an additional deposit to a validator wallet
+
+### Usage
+
+`$ genlayer staking validator-deposit [options] [validator]`
+
+### Arguments
+
+- `[validator]`
+
+### Options
+
+| Short | Long | Description | Required | Default |
+| --- | --- | --- | :---: | --- |
+|  | --validator <address> | Validator wallet contract address (deprecated, use positional arg) | No |  |
+|  | --amount <amount> | Amount to deposit (in wei or with 'eth'/'gen' suffix) | No |  |
+|  | --account <name> | Account to use (must be validator owner) | No |  |
+|  | --password <password> | Password to unlock account (skips interactive prompt) | No |  |
+|  | --network <network> | Network to use (localnet, testnet-asimov) | No |  |
+|  | --rpc <rpcUrl> | RPC URL for the network | No |  |
+| -h | --help | display help for command | No |  |

package/docs/api-references/staking/staking/validator-exit.mdx

@@ -0,0 +1,25 @@
+---
+title: staking validator-exit
+---
+
+Exit as a validator by withdrawing shares
+
+### Usage
+
+`$ genlayer staking validator-exit [options] [validator]`
+
+### Arguments
+
+- `[validator]`
+
+### Options
+
+| Short | Long | Description | Required | Default |
+| --- | --- | --- | :---: | --- |
+|  | --validator <address> | Validator wallet contract address (deprecated, use positional arg) | No |  |
+|  | --shares <shares> | Number of shares to withdraw | No |  |
+|  | --account <name> | Account to use (must be validator owner) | No |  |
+|  | --password <password> | Password to unlock account (skips interactive prompt) | No |  |
+|  | --network <network> | Network to use (localnet, testnet-asimov) | No |  |
+|  | --rpc <rpcUrl> | RPC URL for the network | No |  |
+| -h | --help | display help for command | No |  |

package/docs/api-references/staking/staking/validator-history.mdx

@@ -0,0 +1,29 @@
+---
+title: staking validator-history
+---
+
+Show slash and reward history for a validator (default: last 10 epochs)
+
+### Usage
+
+`$ genlayer staking validator-history [options] [validator]`
+
+### Arguments
+
+- `[validator]`
+
+### Options
+
+| Short | Long | Description | Required | Default |
+| --- | --- | --- | :---: | --- |
+|  | --validator <address> | Validator address (deprecated, use positional arg) | No |  |
+|  | --epochs <count> | Number of recent epochs to fetch | No | `10` |
+|  | --from-epoch <epoch> | Start from this epoch number | No |  |
+|  | --from-block <block> | Start from this block number (advanced) | No |  |
+|  | --all | Fetch complete history from genesis (slow) | No |  |
+|  | --limit <count> | Maximum number of events to show | No | `50` |
+|  | --account <name> | Account to use (for default validator address) | No |  |
+|  | --network <network> | Network to use (localnet, testnet-asimov) | No |  |
+|  | --rpc <rpcUrl> | RPC URL for the network | No |  |
+|  | --staking-address <address> | Staking contract address (overrides chain config) | No |  |
+| -h | --help | display help for command | No |  |

package/docs/api-references/staking/staking/validator-info.mdx

@@ -0,0 +1,25 @@
+---
+title: staking validator-info
+---
+
+Get information about a validator
+
+### Usage
+
+`$ genlayer staking validator-info [options] [validator]`
+
+### Arguments
+
+- `[validator]`
+
+### Options
+
+| Short | Long | Description | Required | Default |
+| --- | --- | --- | :---: | --- |
+|  | --validator <address> | Validator address (deprecated, use positional arg) | No |  |
+|  | --account <name> | Account to use (for default validator address) | No |  |
+|  | --network <network> | Network to use (localnet, testnet-asimov) | No |  |
+|  | --rpc <rpcUrl> | RPC URL for the network | No |  |
+|  | --staking-address <address> | Staking contract address (overrides chain config) | No |  |
+|  | --debug | Show raw unfiltered pending deposits/withdrawals | No |  |
+| -h | --help | display help for command | No |  |

package/docs/api-references/staking/staking/validator-join.mdx

@@ -0,0 +1,22 @@
+---
+title: staking validator-join
+---
+
+Join as a validator by staking tokens
+
+### Usage
+
+`$ genlayer staking validator-join [options]`
+
+### Options
+
+| Short | Long | Description | Required | Default |
+| --- | --- | --- | :---: | --- |
+|  | --amount <amount> | Amount to stake (in wei or with 'eth'/'gen' suffix, e.g., '42000gen') | No |  |
+|  | --operator <address> | Operator address (defaults to signer) | No |  |
+|  | --account <name> | Account to use | No |  |
+|  | --password <password> | Password to unlock account (skips interactive prompt) | No |  |
+|  | --network <network> | Network to use (localnet, testnet-asimov) | No |  |
+|  | --rpc <rpcUrl> | RPC URL for the network | No |  |
+|  | --staking-address <address> | Staking contract address (overrides chain config) | No |  |
+| -h | --help | display help for command | No |  |

package/docs/api-references/staking/staking/validator-prime.mdx

@@ -0,0 +1,25 @@
+---
+title: staking validator-prime
+---
+
+Prime a validator to prepare their stake record for the next epoch
+
+### Usage
+
+`$ genlayer staking validator-prime [options] [validator]`
+
+### Arguments
+
+- `[validator]`
+
+### Options
+
+| Short | Long | Description | Required | Default |
+| --- | --- | --- | :---: | --- |
+|  | --validator <address> | Validator address to prime (deprecated, use positional arg) | No |  |
+|  | --account <name> | Account to use | No |  |
+|  | --password <password> | Password to unlock account (skips interactive prompt) | No |  |
+|  | --network <network> | Network to use (localnet, testnet-asimov) | No |  |
+|  | --rpc <rpcUrl> | RPC URL for the network | No |  |
+|  | --staking-address <address> | Staking contract address (overrides chain config) | No |  |
+| -h | --help | display help for command | No |  |

package/docs/api-references/staking/staking/validators.mdx

@@ -0,0 +1,19 @@
+---
+title: staking validators
+---
+
+Show validator set with stake, status, and voting power
+
+### Usage
+
+`$ genlayer staking validators [options]`
+
+### Options
+
+| Short | Long | Description | Required | Default |
+| --- | --- | --- | :---: | --- |
+|  | --all | Include banned validators | No |  |
+|  | --network <network> | Network to use (localnet, testnet-asimov) | No |  |
+|  | --rpc <rpcUrl> | RPC URL for the network | No |  |
+|  | --staking-address <address> | Staking contract address (overrides chain config) | No |  |
+| -h | --help | display help for command | No |  |