# ACC-20C 兼容层协议 - 主接口文件
# 版本: 1.0
# 路径: charter-std/acc/acc20c.ch

# --- 核心原则 ---
# 1. 统一入口: 本文件是 ACC-20C 协议在 Charter 合约层的唯一入口点。
# 2. 模块化: 导入并重新导出 Wrapper, Metadata, Sync 三个核心模块的接口。
# 3. 接口标准化: 定义清晰的 IAcc20C 接口，供其他合约调用。

# --- 模块导入 ---

# 导入并公开包装器模块
pub mod wrapper from "./acc20c_wrapper.ch";

# 导入并公开元数据模块
pub mod metadata from "./acc20c_metadata.ch";

# 导入并公开状态同步模块
pub mod sync from "./acc20c_sync.ch";

# --- 标准库导入 ---
import std::types::{ Address, Uint256, Bool, String };

# --- 统一接口定义 (IACC20C) ---

# @dev 定义 ACC-20C 协议的统一外部接口
# 其他合约应通过此接口与 ACC-20C 交互
interface IAcc20C {

    # --- Wrapper 功能 ---

    # @dev 包装一个 ACC-20 资产
    fn wrap(acc20_contract: Address, acc20_token_id: Uint256) -> Uint256;

    # @dev 解包一个已包装的资产
    fn unwrap(wrapper_token_id: Uint256);

    # @dev 转移一个包装后资产的所有权
    fn transfer(to: Address, wrapper_token_id: Uint256);

    # @dev 查询包装后资产的详情
    fn get_wrapped_asset(wrapper_token_id: Uint256) -> wrapper::WrappedAsset;

    # @dev 查询包装后资产的所有者
    fn owner_of(wrapper_token_id: Uint256) -> Address;

    # --- Metadata 功能 ---

    # @dev 为指定的包装资产生成完整的元数据 URI
    fn token_uri(wrapper_token_id: Uint256) -> String;

    # --- Sync 功能 (仅限授权服务调用) ---

    # @dev 由区块扫描器调用，以更新底层资产估值
    fn update_valuation(acc20_contract: Address, acc20_token_id: Uint256, new_valuation: Uint256);

    # @dev 由区块扫描器调用，处理底层资产状态的重大变更
    fn handle_critical_status_change(acc20_contract: Address, acc20_token_id: Uint256, new_status_code: Uint64);
}

# --- 占位符函数 (保持向后兼容性) ---
# 这些函数将被废弃，但暂时保留以避免破坏现有引用。实际逻辑由宪法层处理。

pub fn verify_compliance(holder: Address) -> bool {
    # [DEPRECATED] 合规性检查已移至宪法层 (CEE)
    # 此函数始终返回 true，实际检查由 CBPP 在交易准入时强制执行
    return true;
}

pub fn add_to_whitelist(account: Address) -> bool {
    # [DEPRECATED] 白名单机制已被 CNNL 宪法条款取代
    return true;
}

pub fn remove_from_whitelist(account: Address) -> bool {
    # [DEPRECATED] 白名单机制已被 CNNL 宪法条款取代
    return true;
}

pub fn is_whitelisted(account: Address) -> bool {
    # [DEPRECATED] 白名单机制已被 CNNL 宪法条款取代
    return true;
}