initialize

fn initialize(env: Env, admin: Address)

Sets the admin address and initializes the auto-incrementing counters (NextPlanId = 1, NextSubId = 1). This function can only be called once - subsequent calls will fail with AlreadyInitialized.

This is a one-time setup function. Once called, it cannot be called again. Make sure the admin address is correct before deploying.

Parameters

Name	Type	Description
`admin`	`Address`	The admin address that will be stored in instance storage.

Authorization

None. This function has no require_auth() call - it relies on the fact that it can only succeed once. The first caller sets the admin.

Return value

None (void).

Events emitted

None.

Error cases

Code	Name	Description
1	`AlreadyInitialized`	The contract has already been initialized.

Examples

Soroban CLI
SDK

This is typically a one-time setup performed via the CLI immediately after contract deployment.

soroban contract invoke \
  --id CONTRACT_ID \
  --network testnet \
  --source DEPLOYER_SECRET \
  -- \
  initialize \
  --admin GADMIN...ADDR

While initialize is typically called via the CLI, the SDK does expose it:

import { VowenaClient, NETWORKS } from "vowena";

const client = new VowenaClient({
  contractId: NETWORKS.testnet.contractId,
  rpcUrl: NETWORKS.testnet.rpcUrl,
  networkPassphrase: NETWORKS.testnet.networkPassphrase,
});

const tx = await client.buildInitialize({
  admin: "GADMIN...ADDR",
});

const signedXdr = await signTransaction(tx);
await client.submitTransaction(signedXdr);

After initialization, the admin address is stored in instance storage and shares the contract’s TTL. The counters start at 1, so the first plan created will have plan_id = 1 and the first subscription will have sub_id = 1.

Overview

Core

Management

Migrations

Read-only

Parameters

Authorization

Return value

Events emitted

Error cases

Examples

Overview

Core

Management

Migrations

Read-only

​Parameters

​Authorization

​Return value

​Events emitted

​Error cases

​Examples

Parameters

Authorization

Return value

Events emitted

Error cases

Examples