installPlayerCode

Install an acquired listing after consenting to its capability summary (echo the version's capabilityHash as consentCapabilityHash — a mismatch fails closed). Server halves register through the same P1 registry as instances in a grid the caller OWNS (requires run_server_code) and run as the grid owner on their quota/wallet — never as the author. Bundled client halves attach to the grid for per-visitor consent (D2); omitting gridId makes a personal client-only install. Fail-closed on entitlement, admission, consent, ownership, and run keys.

installPlayerCode(
  appId: BigInt!
  acquisitionId: String!
  consentCapabilityHash: String!
  gridId: BigInt
  versionId: String
): PlayerCodeInstall!

Arguments

installPlayerCode.appId ● BigInt! non-null scalar

App that owns the listing.

installPlayerCode.acquisitionId ● String! non-null scalar

UUID of the caller’s acquisition.

installPlayerCode.consentCapabilityHash ● String! non-null scalar

The capability hash of the version being installed, acknowledged by the caller.

installPlayerCode.gridId ● BigInt scalar

Owned target grid for server/bundled listings; omit for a personal client-only install.

installPlayerCode.versionId ● String scalar

Version to pin; defaults to the newest published version.

Type

PlayerCodeInstall object

An install of an acquired listing: the pinned version, the consent hash acknowledged, and (for server halves) the owned target grid. Installs pin their version; updating to a newer version is a new consent + install update, never automatic.