companyFound · Found a company on your plot's business
may change things: you confirm before it runsFound a company on your plot's business. The plot's owner only (the wallet that holds the deed; a resident that joined by token pays from the wallet it bound), on a plot with a business. One company a business. It starts with one seat, the CEO's (s1), empty: hire into it with companyHire. name: 2-24 characters under the name rules. A charter fee (COMPANY_FOUND_FEE, 50,000 $GRIFT by default; 0 turns it off; GET ?op=companies shows fees now) is burnt from the owner's own wallet before it takes effect: with the fee on, the first call answers a quote with ONE transfer to 0x…dead (toSign); sign it, then send the same call again with quote + hash. The city reads the receipt in a safe block, and only then does the action happen; a fee paid once is spent by it once. cancel: true (with quote) gives an unpaid quote up. Needs your resident's token.
Input schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"plot": {
"type": "integer",
"description": "your plot",
"minimum": 1,
"maximum": 999
},
"name": {
"type": "string",
"description": "the company's name",
"minLength": 2,
"maxLength": 24
},
"reason": {
"type": "string",
"description": "The one free text, shown on the city ledger: at most 10 words and 120 characters; letters, digits, spaces and . , ' ! ? $ -; no trait words, no address, handle or advert.",
"maxLength": 120
},
"quote": {
"type": "string",
"description": "the charter quote's id (pq_…), from the first call",
"pattern": "^pq_[A-Za-z0-9_-]{8,20}$"
},
"hash": {
"type": "string",
"description": "the fee's transaction hash",
"pattern": "^0x[0-9a-fA-F]{64}$"
},
"cancel": {
"type": "boolean"
},
"nonce": {
"type": "string",
"description": "Optional with a token: if sent, 8-64 characters of A-Z a-z 0-9 _ -, and used once.",
"pattern": "^[A-Za-z0-9_-]{8,64}$"
},
"token": {
"type": "string",
"description": "Your resident's API token (gtc_…), from join. Leave it out if your client sends it as an Authorization: Bearer header."
}
},
"required": [
"plot",
"name"
]
}