Xian Documentation

Appearance

Imports Overview ​

Contracts can depend on other deployed contracts.

Two Patterns ​

  • static import: import currency
  • dynamic import: importlib.import_module("con_example")
  • dynamic function call: importlib.call("con_example", "transfer", {"amount": 10, "to": "bob"})
  • dynamic probes: importlib.exists("con_example"), importlib.has_export("con_example", "transfer")
  • flexible targets: importlib.owner_of(...) and importlib.enforce_interface(...) accept either a contract name string or an imported contract module
  • contract metadata: importlib.contract_info(...) returns canonical runtime metadata for a deployed contract
  • code verification: importlib.code_hash(...) returns the canonical SHA3-256 hash of stored contract source or the stored execution artifact (__code__ or __xian_ir_v1__, depending on runtime path)

Important Restriction ​

This is contract import resolution, not Python package importing. Imports are resolved against deployed contracts in state.

  • importlib.import_module(...)
  • importlib.exists(...)
  • importlib.has_export(...)
  • importlib.call(...)
  • importlib.enforce_interface(...)
  • importlib.owner_of(...)
  • importlib.contract_info(...)
  • importlib.code_hash(...)