Skip to main content
A fee wrapper is an organization-specific contract over an existing gVault. It adds performance-fee accounting and its own customer allowlist. Provisioning a wrapper does not create the underlying gVault.

​
Provision a wrapper

Select a gVaultId from the gVault catalogue and generate a UUID v4:
performanceFeeBps is the share of gains above the high-water mark paid to the fee recipient. 2000 is 20%. The initial rate is also the wrapper’s permanent maximum; creating it with zero prevents enabling a performance fee later. Use the same requestId when retrying the same logical request. Reusing it with different parameters returns 409 request_id_conflict.

​
Wait for readiness

The create call returns 202 while provisioning is in progress. Poll the resource:
Do not send customer transactions until status is ready. At that point, persist both id for API calls and contractAddress for onchain calls. Ground has also authorized the wrapper against its underlying gVault. If your original response was lost, recover by provisioning request:

​
Update the fee configuration

Omit a field to leave it unchanged. The contract accrues fees under the old configuration before applying the update. The new rate cannot exceed maxPerformanceFeeBps. API reference: provision, list, get, and update fees.