Instrument commands: grant
The Instrument Verbs grant as CLI commands, with inputs, result, refusals and an example.
Reference for Instrument, one group of Instrument commands.
Instrument.grant
Grant gives a Holder an option from the pool, with its strike price, vesting schedule and cliff. Verb page.
npx startup-builder do Instrument.grant --json '<input>' [--try | --send | --do]Emits Instrument.granted.
Inputs
| Input | Type | Required | Description |
|---|---|---|---|
holder | Holder | required | The Holder who receives the option, usually a Worker. |
quantity | integer | required | The Shares the option covers. |
strike | money | required | The exercise price, at or above the latest fair market value. |
vesting | json | required | The schedule and cliff. |
Returns
| Output | Type | Required | Description |
|---|---|---|---|
instrument | Instrument | required | The granted option. |
Refuses when
| Check | Error | Fix | Then call |
|---|---|---|---|
| The key is valid, but its scopes do not allow this operation. | forbidden | Use a key whose scopes cover the operation, or ask an owner of the namespace to grant them. | None. |
| A strike below the latest 409A fair market value | refused | Clear what the check names, then call it again. | None. |
Example
npx startup-builder do Instrument.grant --json '{"holder":