fn accept_migration(env: Env, subscriber: Address, sub_id: u64) -> u64
Parameters
| Name | Type | Description |
|---|
subscriber | Address | The subscriber’s Stellar address. Must sign the transaction. |
sub_id | u64 | The old subscription ID with a pending migration. |
Authorization
subscriber.require_auth();
accept_migration() call, the old subscription cancellation, and the new token.approve() for the target plan.
Return value
u64 - the new subscription ID on the target plan.
Events emitted
| Event | Topics | Data |
|---|
mig_accept | subscriber, old_sub_id, new_sub_id | Migration details |
Error cases
| Code | Name | Description |
|---|
| 9 | Unauthorized | Caller is not the subscriber on this subscription. |
| 12 | NoMigrationPending | No migration has been requested for this subscription. |
Examples
import { VowenaClient, NETWORKS } from "vowena";
const client = new VowenaClient({
contractId: NETWORKS.testnet.contractId,
rpcUrl: NETWORKS.testnet.rpcUrl,
networkPassphrase: NETWORKS.testnet.networkPassphrase,
});
// Accept the pending migration
const tx = await client.buildAcceptMigration(
"GSUBSCRIBER...ADDR", // Subscriber's address
oldSubscriptionId // Old subscription ID
);
const signedXdr = await signTransaction(tx);
const result = await client.submitTransaction(signedXdr);
console.log("New subscription ID:", result.subscriptionId);
soroban contract invoke \
--id CONTRACT_ID \
--network testnet \
--source SUBSCRIBER_SECRET \
-- \
accept_migration \
--subscriber GSUBSCRIBER...ADDR \
--sub_id 1
The new subscription inherits the subscriber’s billing history context but starts fresh on the new plan’s terms. The old subscription is permanently cancelled. The new allowance is calculated based on the new plan’s price_ceiling and max_periods.
