Skip to content

MsgUpdateDynamicStore

MsgUpdateDynamicStore replaces a dynamic store's default value, global kill switch, and metadata. Creator only.

Replaces the default value, the globalEnabled kill switch, and the metadata of a dynamic store. Only the store's creator can sign it. Every field is overwritten, so pass the current values for anything you want to keep.

Example

bash
# [store-id] [default-value] [global-enabled]
bb tx tokenization update-dynamic-store 1 false false --from alice --chain-id bitbadges-1
ts
import { BitBadgesSigningClient, GenericCosmosAdapter, MsgUpdateDynamicStore } from 'bitbadges';

const adapter = await GenericCosmosAdapter.fromMnemonic(process.env.MNEMONIC!, 'bitbadges-1');
const client = new BitBadgesSigningClient({ adapter, network: 'mainnet' });

// Halt every approval that depends on store 1.
const msg = new MsgUpdateDynamicStore({
  creator: 'bb1p0rrel3365scadq5k9pv0x0zp9j22js6dnw70d',
  storeId: 1n,
  defaultValue: false,
  globalEnabled: false,
  uri: '',
  customData: '{"name":"Demo Membership allowlist"}'
});

const result = await client.signAndBroadcast([msg]);
console.log(result.txHash, result.success);
json
{
  "creator": "bb1p0rrel3365scadq5k9pv0x0zp9j22js6dnw70d",
  "storeId": "1",
  "defaultValue": false,
  "globalEnabled": false,
  "uri": "",
  "customData": "{\"name\":\"Demo Membership allowlist\"}"
}

To change only the metadata, pass the current defaultValue and globalEnabled:

json
{
  "creator": "bb1p0rrel3365scadq5k9pv0x0zp9j22js6dnw70d",
  "storeId": "1",
  "defaultValue": false,
  "globalEnabled": true,
  "uri": "",
  "customData": "{\"name\":\"Demo Membership allowlist\",\"updated\":1788739200000}"
}

To clear the metadata, pass empty strings.

Ask your agent:

text
Halt dynamic store 1 so every approval that checks it fails until I turn it back on.

Fields

FieldTypeRequiredDescription
creatorstringyesSigner. Must equal the store's createdBy.
storeIdUintyesStore to update.
defaultValueboolyesNew default for addresses without an entry.
globalEnabledboolyesfalse halts every approval that uses this store. Proto3 bools default to false, so pass true explicitly to keep the store enabled.
uristringnoNew metadata URI. Empty clears it.
customDatastringnoNew custom data. Empty clears it.

The response is empty.

Behavior

  • Fails with ErrInvalidDynamicStoreID if the store does not exist or the signer is not its creator.
  • All four fields are written unconditionally. Query GetDynamicStore first if you need to preserve values.
  • When globalEnabled is false, every DynamicStoreChallenge that references the store fails with dynamic store storeId {id} is globally disabled, regardless of per-address values. Use it as an emergency stop, for example when a dependent protocol is compromised.
  • Per-address values set with MsgSetDynamicStoreValue are not touched.

Edit this page on GitHub