feat: add XCS registry permissioning and docs

cosmwasm/contracts/crosschain-registry/README.md

@@ -0,0 +1,60 @@
+# Swap Router Registry Contract
+
+This is a CosmWasm smart contract that allows the creation and maintenance of cross-chain connection channels between IBC-enabled blockchains. This contract acts as a central registry where various blockchains can create, update, and delete IBC channels in a coordinated way, without having to deal with the complexity of handling low-level details when creating cross-chain swap messages.
+
+The registry contains the following mappings:
+
+- contract alias to contract address
+  - maps a human-readable name to the address of a target contract
+- chain channel to source chain/destination chain
+  - maps a channel number to the source and destination chains it connects to
+- chain name to Bech32 prefix
+  - maps a chain name to its corresponding Bech32 prefix, which is used for address encoding
+
+It also exposes a query entry point to retrieve the address from the alias, the destination chain from the source chain via the channel, the channel from the chain pair, the bech32 prefix from the chain name, and the native denom on the source chain from the IBC denom trace.
+
+All registry connections can be created, modified, and deleted by the contract owner. For each source_chain, the contract owner can specify an address that is allowed to create, modify, and delete registry connections for that source_chain and that source_chain alone. This allows other chains to maintain their own registry while keeping all the information consolidated on a single contract.
+
+## Operations
+
+### ModifyContractAlias
+
+The `ModifyContractAlias` operation allows the contract owner to create, update, or delete aliases that can be used to identify contracts on other blockchains. The operation expects a vector of ContractAliasOperation, where each operation is either a CreateAlias, UpdateAlias, or DeleteAlias operation.
+
+### ModifyChainChannelLinks
+
+The `ModifyChainChannelLinks` operation allows the owner (or an authorized address for a specific source_chain) to create, update, or delete IBC channel links between each chain. The operation expects a vector of ConnectionOperation, where each operation is either a CreateConnection, UpdateConnection, or DeleteConnection operation.
+
+### ModifyBech32Prefixes
+
+The `ModifyBech32Prefixes` operation allows the owner (or an authorized address for a specific source_chain) to create, update, or delete Bech32 prefixes for each chain. The operation expects a vector of ChainToPrefixOperation, where each operation is either a CreatePrefix, UpdatePrefix, or DeletePrefix operation.
+
+### UnwrapCoin
+
+The `UnwrapCoin` operation allows the contract to take an IBC denom and unwrap it into a memo that can be used by the crosschain swaps contract to send the coins to the source chain.
+
+## Queries
+
+### GetAddressFromAlias
+
+The `GetAddressFromAlias` query allows a caller to retrieve the address of a contract on another blockchain, given the alias of that contract.
+
+### GetDestinationChainFromSourceChainViaChannel
+
+The `GetDestinationChainFromSourceChainViaChannel` query allows a caller to retrieve the destination chain for an IBC channel given the source chain and the channel id.
+
+### GetChannelFromChainPair
+
+The `GetChannelFromChainPair` query allows a caller to retrieve the channel id for an IBC channel given the source and destination chain.
+
+### GetBech32PrefixFromChainName
+
+The `GetBech32PrefixFromChainName` query allows a caller to retrieve the Bech32 prefix for a given chain.
+
+### GetDenomTrace
+
+The `GetDenomTrace` query allows a caller to retrieve the denom trace for a given IBC denom.
+
+### UnwrapDenom
+
+The `UnwrapDenom` query allows a caller to retrieve the denom trace for a given IBC denom and then unwrap it into its constituent coins on the originating blockchain.

cosmwasm/contracts/crosschain-registry/src/contract.rs

@@ -42,17 +42,22 @@ pub fn execute(
     match msg {
         // Contract aliases
         ExecuteMsg::ModifyContractAlias { operations } => {
-            execute::contract_alias_operations(deps, operations)
+            execute::contract_alias_operations(deps, info.sender, operations)
         }
 
         // Chain channel links
         ExecuteMsg::ModifyChainChannelLinks { operations } => {
-            execute::connection_operations(deps, operations)
+            execute::connection_operations(deps, info.sender, operations)
         }
 
         // Bech32 prefixes
         ExecuteMsg::ModifyBech32Prefixes { operations } => {
-            execute::chain_to_prefix_operations(deps, operations)
+            execute::chain_to_prefix_operations(deps, info.sender, operations)
+        }
+
+        // Authorized addresses
+        ExecuteMsg::ModifyAuthorizedAddresses { operations } => {
+            execute::authorized_address_operations(deps, info.sender, operations)
         }
 
         ExecuteMsg::UnwrapCoin { receiver } => {

cosmwasm/contracts/crosschain-registry/src/error.rs

@@ -104,4 +104,7 @@ pub enum ContractError {
 
     #[error("missing field: {field:?}")]
     MissingField { field: String },
+
+    #[error("custom error: {msg:?}")]
+    CustomError { msg: String },
 }