Interop

Interop calls are the bridge between VM bytecode and native chain functionality. A script uses EXTCALL with a method name such as Runtime.TransferTokens or Data.Get, and the validator handles the real token, NFT, storage, or contract lifecycle operation in native code.

This page reflects the current Carbon validator behavior. It is not a wishlist and it is not an archival Gen2 table.

How To Think About Interop

Interop methods fall into three practical buckets:

• fully implemented and safe to rely on

• implemented but narrow, with important behavior notes

• not implemented yet and currently rejected

The rest of this page is organized that way.

Runtime Context And Utility

These methods are currently available.

Method	Args	Status	Notes
Runtime.GasTarget	none	implemented	Returns the gas target address for the current execution.
Runtime.Context	none	implemented	Requires a real current context; rejects if context is not available yet.
Runtime.PreviousContext	none	implemented	Returns the parent context name.
Runtime.IsTrigger	none	implemented	Returns whether the current execution is inside a trigger path.
Runtime.GenerateUID	none	implemented	Monotonic within execution; used to preserve expected UID semantics across interop calls.
Runtime.Time	none	implemented	Returns current block time as VM timestamp.
Runtime.Version	none	implemented	Returns current VM behavior version.
Runtime.IsWitness	address	implemented	Checks whether the address is currently witnessed.
Runtime.Log	message	implemented	Emits a VM-side log line.
Runtime.Notify	eventKind, address, payload	implemented	Requires a real deployed contract context; emits a contract event payload.

These names exist in older tables but are not implemented in the current validator and should not be documented as working:

• Runtime.TransactionHash

• Runtime.Validator

• Runtime.Random

• Runtime.SetSeed

• Runtime.IsMinter

Contract Lifecycle

Method	Args	Status	Notes
Runtime.DeployContract	from, contractName, script, abi	implemented	Deploys a standalone custom contract. Requires minimal proof of work. Custom names are lowercase.
Runtime.UpgradeContract	from, contractName, script, abi	implemented	Upgrades an existing deployed contract. Also used later for token-backed contracts after they already exist. Requires minimal proof of work.
Runtime.KillContract	from, contractName	not implemented	Do not document as a working flow yet.
Nexus.CreateToken	from, script, abi	implemented	Creates a new token-backed contract from contract metadata. Requires minimal proof of work.
Nexus.AttachTokenContract	from, symbol, script, abi	implemented	Attaches VM code to an already existing token. Requires minimal proof of work and current validator version support.

Important lifecycle rules:

• Runtime.DeployContract is for standalone custom contracts, not uppercase token symbols.

• Nexus.CreateToken is the install path for a new token-backed contract.

• Nexus.AttachTokenContract is the install path for an existing token that does not yet have VM code attached.

• Runtime.UpgradeContract is the later update path for both standalone contracts and already-installed token-backed contracts.

• Token-backed create and attach flows require a valid token contract shape. In practice, onMint is mandatory.

Fungible Token Operations

Method	Args	Status	Notes
Runtime.GetBalance	address, symbol	implemented	Returns the current fungible balance.
Runtime.TransferTokens	source, destination, symbol, amount	implemented	Main fungible transfer interop.
Runtime.TransferBalance	source, destination, symbol	implemented	Transfers the full current balance for that symbol.
Runtime.MintTokens	source, destination, symbol, amount	implemented	Current Carbon implementation includes trigger-aware atomic behavior.
Runtime.BurnTokens	address, symbol, amount	implemented	Gas charging changed over time; current validator behavior is the source of truth.
Runtime.SwapTokens	-	not implemented	Still rejected.

NFT And Token-Backed Operations

Method	Args	Status	Notes
Runtime.GetOwnerships	address, symbol	implemented	NFT-only. Returns a deterministic BigInteger[]-style VM object of owned Phantasma NFT IDs.
Runtime.TransferToken	source, destination, symbol, tokenID	implemented	Uses runtime-visible Phantasma NFT IDs, not raw Carbon instance IDs.
Runtime.MintToken	source, destination, symbol, rom, ram, seriesID	implemented	Uses Phantasma series metadata IDs and preserves VM-facing ROM behavior. Triggers onMint when token-backed contract code exists.
Runtime.BurnToken	source, symbol, tokenID	implemented	NFT burn path.
Runtime.InfuseToken	source, targetSymbol, tokenID, infuseSymbol, value	implemented	Current docs should describe this as the supported infuse path, not as a TODO.
Runtime.ReadTokenROM	symbol, tokenID	implemented	Reads runtime-visible ROM.
Runtime.ReadTokenRAM	symbol, tokenID	implemented	Reads runtime-visible RAM.
Runtime.ReadToken	symbol, tokenID[, fields]	implemented	Returns a map-like VM object for requested fields. Defaults to chain,owner,creator,ROM,RAM,tokenID,seriesID,mintID,infusion.
Runtime.ReadInfusions	symbol, tokenID	implemented	Rebuilds Phantasma-style infusion view from current Carbon balances.
Runtime.WriteToken	from, symbol, tokenID, ram	not implemented	Still explicitly left as future parity work.

For Runtime.ReadToken and related NFT interops, the current validator intentionally treats the public Phantasma NFT ID as the runtime identity. Internal Carbon instance IDs stay an internal storage detail.

Token Metadata And Discovery

Method	Args	Status	Notes
Runtime.TokenExists	symbol	implemented	Returns false for unknown symbols instead of hard failing.
Runtime.GetTokenDecimals	symbol	implemented	Reads token decimals from current token metadata.
Runtime.GetTokenFlags	symbol	implemented	Reads current token flags.
Runtime.GetTokenOwner	symbol	implemented	Returns the current token owner address object.

Older public tables sometimes mention Runtime.GetTokenSupply or Runtime.GetAvailableTokenSymbols. Those methods are not part of the current Carbon VM interop surface and should not be documented as available.

NFT Series

Method	Args	Status	Notes
Nexus.CreateTokenSeries	from, symbol, seriesID, maxSupply, mode, script, abi	implemented	Uses Phantasma metadata _i for series identity and validates the caller before running onSeries.

Important notes:

• series creation is separate from token creation or token attach

• same-token token-backed series flows preserve both token identity and outer user witness where required

• series metadata persists canonical Phantasma fields for later runtime use

Contract Storage

These are the storage primitives contract authors rely on most.

Method	Args	Status	Notes
Data.Get	contractName, field, vmType	implemented	Reads a contract scalar field and returns a typed default when missing.
Data.Set	field, value	implemented	Writes into the current deployed contract context only.
Data.Delete	field	implemented	Deletes a scalar field from the current deployed contract context.
Map.Has	contractName, field, key, keyType	implemented	Checks whether a map-style entry exists. The current implementation consumes the extra type argument for compatibility even though the existence check itself is key-based.
Map.Get	contractName, field, key, vmType	implemented	Reads a map entry and returns a typed default when missing.
Map.Set	field, key, value	implemented	Updates table storage and keeps canonical entry counts.
Map.Remove	field, key	implemented	Removes an entry and updates count.
Map.Count	contractName, field	implemented	Returns current entry count.
Map.Clear	field	implemented	Deletes all entries and resets count.
Map.Keys	contractName, field	implemented	Returns a byte-array vector of current keys.
List.Get	contractName, field, index, vmType	implemented	Reads by zero-based index.
List.Add	field, value	implemented	Appends at the current tail index.
List.Replace	field, index, value	implemented	Replaces an existing list entry.
List.RemoveAt	field, index	implemented	Uses compact swap-with-last semantics.
List.Count	contractName, field	implemented	Returns current list length.
List.Clear	field	implemented	Deletes list entries and resets count.

Storage behavior notes:

• write methods operate on the current deployed contract context, not an arbitrary named contract

• read methods can target another contract by name

• collection storage uses canonical count tracking under the hood, so imported or malformed storage can still be rejected if it breaks expected layout

Account And Constructor Helpers

Method	Args	Status	Notes
Account.Name	address	implemented	Resolves a name through governance lookup.
Address()	addressLike	implemented	Builds or normalizes an address object.
Hash()	hashLike	implemented	Builds a hash object.
Timestamp()	timestampLike	implemented	Builds a timestamp value.

These are still not implemented:

• Account.LastActivity

• Account.Transactions

• ABI()

Organization, Oracle, And Task Namespaces

Current Carbon still rejects these as unimplemented:

• Organization.AddMember

• Organization.RemoveMember

• Organization.Kill

• Oracle.Read

• Oracle.Price

• Oracle.Quote

• Task.Start

• Task.Stop

• Task.Get

• Task.Current

• Nexus.GetGovernanceValue

• Nexus.BeginInit

• Nexus.EndInit

• Nexus.MigrateToken

• Nexus.CreateChain

• Nexus.CreatePlatform

• Nexus.CreateOrganization

• Nexus.SetPlatformTokenHash

Developer Guidance

If you are writing new contracts today:

• use Runtime.DeployContract and Runtime.UpgradeContract for standalone contracts

• use Nexus.CreateToken, Nexus.AttachTokenContract, and later Runtime.UpgradeContract for token-backed contracts

• rely on Data.*, Map.*, and List.* for persistent state

• rely on Runtime.MintTokens, Runtime.TransferTokens, Runtime.MintToken, Runtime.TransferToken, Runtime.ReadToken, and Nexus.CreateTokenSeries for current token and NFT flows

• do not build new docs or examples around methods that are still rejected with TODO paths