Correct the "tests and docs" test in the documentation. (#4250)

## Motivation

The merging of the PR #4210 led to some problems because the `Operation`
and `Abi` types are no longer
accessible when publishing. The use of example types is fine only for
tests, not for benchmarks.

## Proposal

Put back the `NativeFungibleTokenAbi` and `FungibleTokenAbi` in the
`linera-sdk::abis::fungible` and rename as needed.

## Test Plan

The `script/test_publish.sh` was used.

## Release Plan

- Nothing to do / These changes follow the usual release cycle.

## Links

None.

Author: MathieuDutSik

examples/amm/src/contract.rs

@@ -6,8 +6,9 @@
 mod state;
 
 use amm::{AmmAbi, Message, Operation, Parameters};
-use fungible::{Account, FungibleTokenAbi};
+use fungible::Account;
 use linera_sdk::{
+    abis::fungible::{FungibleOperation, FungibleResponse, FungibleTokenAbi},
     linera_base_types::{AccountOwner, Amount, ApplicationId, ChainId, WithContractAbi},
     views::{RootView, View},
     Contract, ContractRuntime,
@@ -673,7 +674,7 @@ impl AmmContract {
         token_idx: u32,
     ) {
         let token = self.fungible_id(token_idx);
-        let operation = fungible::Operation::Transfer {
+        let operation = FungibleOperation::Transfer {
             owner: source_owner,
             amount,
             target_account,
@@ -683,10 +684,10 @@ impl AmmContract {
     }
 
     fn balance(&mut self, owner: &AccountOwner, token_idx: u32) -> Amount {
-        let balance = fungible::Operation::Balance { owner: *owner };
+        let balance = FungibleOperation::Balance { owner: *owner };
         let token = self.fungible_id(token_idx);
         match self.runtime.call_application(true, token, &balance) {
-            fungible::FungibleResponse::Balance(balance) => balance,
+            FungibleResponse::Balance(balance) => balance,
             response => panic!("Unexpected response from fungible token application: {response:?}"),
         }
     }

examples/crowd-funding/src/contract.rs

@@ -8,6 +8,7 @@ mod state;
 use crowd_funding::{CrowdFundingAbi, InstantiationArgument, Message, Operation};
 use fungible::{Account, FungibleTokenAbi};
 use linera_sdk::{
+    abis::fungible::FungibleOperation,
     linera_base_types::{AccountOwner, Amount, ApplicationId, WithContractAbi},
     views::{RootView, View},
     Contract, ContractRuntime,
@@ -100,7 +101,7 @@ impl CrowdFundingContract {
         // TODO(#589): Simplify this when the messaging system guarantees atomic delivery
         // of all messages created in the same operation/message.
         let target_account = Account { chain_id, owner };
-        let call = fungible::Operation::Transfer {
+        let call = FungibleOperation::Transfer {
             owner,
             amount,
             target_account,
@@ -195,11 +196,9 @@ impl CrowdFundingContract {
     fn balance(&mut self) -> Amount {
         let owner = self.runtime.application_id().into();
         let fungible_id = self.fungible_id();
-        let response = self.runtime.call_application(
-            true,
-            fungible_id,
-            &fungible::Operation::Balance { owner },
-        );
+        let response =
+            self.runtime
+                .call_application(true, fungible_id, &FungibleOperation::Balance { owner });
         match response {
             fungible::FungibleResponse::Balance(balance) => balance,
             response => panic!("Unexpected response from fungible token application: {response:?}"),
@@ -212,7 +211,7 @@ impl CrowdFundingContract {
             chain_id: self.runtime.chain_id(),
             owner,
         };
-        let transfer = fungible::Operation::Transfer {
+        let transfer = FungibleOperation::Transfer {
             owner: self.runtime.application_id().into(),
             amount,
             target_account,
@@ -227,7 +226,7 @@ impl CrowdFundingContract {
             chain_id: self.runtime.chain_id(),
             owner: self.runtime.application_id().into(),
         };
-        let transfer = fungible::Operation::Transfer {
+        let transfer = FungibleOperation::Transfer {
             owner,
             amount,
             target_account,

examples/fungible/src/contract.rs

@@ -6,7 +6,8 @@
 mod state;
 
 use fungible::{
-    Account, FungibleResponse, FungibleTokenAbi, InitialState, Message, Operation, Parameters,
+    Account, FungibleOperation, FungibleResponse, FungibleTokenAbi, InitialState, Message,
+    Parameters,
 };
 use linera_sdk::{
     linera_base_types::{AccountOwner, Amount, WithContractAbi},
@@ -56,17 +57,17 @@ impl Contract for FungibleTokenContract {
 
     async fn execute_operation(&mut self, operation: Self::Operation) -> Self::Response {
         match operation {
-            Operation::Balance { owner } => {
+            FungibleOperation::Balance { owner } => {
                 let balance = self.state.balance_or_default(&owner).await;
                 FungibleResponse::Balance(balance)
             }
 
-            Operation::TickerSymbol => {
+            FungibleOperation::TickerSymbol => {
                 let params = self.runtime.application_parameters();
                 FungibleResponse::TickerSymbol(params.ticker_symbol)
             }
 
-            Operation::Approve {
+            FungibleOperation::Approve {
                 owner,
                 spender,
                 allowance,
@@ -78,7 +79,7 @@ impl Contract for FungibleTokenContract {
                 FungibleResponse::Ok
             }
 
-            Operation::Transfer {
+            FungibleOperation::Transfer {
                 owner,
                 amount,
                 target_account,
@@ -92,7 +93,7 @@ impl Contract for FungibleTokenContract {
                 FungibleResponse::Ok
             }
 
-            Operation::TransferFrom {
+            FungibleOperation::TransferFrom {
                 owner,
                 spender,
                 amount,
@@ -109,7 +110,7 @@ impl Contract for FungibleTokenContract {
                 FungibleResponse::Ok
             }
 
-            Operation::Claim {
+            FungibleOperation::Claim {
                 source_account,
                 amount,
                 target_account,

examples/fungible/src/lib.rs

@@ -3,13 +3,9 @@
 
 /* ABI of the Fungible Token Example Application */
 
-use async_graphql::{scalar, Request, Response};
+use async_graphql::scalar;
 pub use linera_sdk::abis::fungible::*;
-use linera_sdk::{
-    abi::{ContractAbi, ServiceAbi},
-    graphql::GraphQLMutationRoot,
-    linera_base_types::{AccountOwner, Amount},
-};
+use linera_sdk::linera_base_types::{AccountOwner, Amount};
 use serde::{Deserialize, Serialize};
 #[cfg(all(any(test, feature = "test"), not(target_arch = "wasm32")))]
 use {
@@ -65,71 +61,6 @@ impl OwnerSpender {
     }
 }
 
-/// An ABI for applications that implement a fungible token.
-pub struct FungibleTokenAbi;
-
-impl ContractAbi for FungibleTokenAbi {
-    type Operation = Operation;
-    type Response = FungibleResponse;
-}
-
-impl ServiceAbi for FungibleTokenAbi {
-    type Query = Request;
-    type QueryResponse = Response;
-}
-
-/// An operation
-#[derive(Debug, Deserialize, Serialize, GraphQLMutationRoot)]
-pub enum Operation {
-    /// Requests an account balance.
-    Balance {
-        /// Owner to query the balance for
-        owner: AccountOwner,
-    },
-    /// Requests this fungible token's ticker symbol.
-    TickerSymbol,
-    /// Approve the transfer of tokens
-    Approve {
-        /// Owner to transfer from
-        owner: AccountOwner,
-        /// The spender account
-        spender: AccountOwner,
-        /// Maximum amount to be transferred
-        allowance: Amount,
-    },
-    /// Transfers tokens from a (locally owned) account to a (possibly remote) account.
-    Transfer {
-        /// Owner to transfer from
-        owner: AccountOwner,
-        /// Amount to be transferred
-        amount: Amount,
-        /// Target account to transfer the amount to
-        target_account: Account,
-    },
-    /// Transfers tokens from a (locally owned) account to a (possibly remote) account by using the allowance.
-    TransferFrom {
-        /// Owner to transfer from
-        owner: AccountOwner,
-        /// The spender of the amount.
-        spender: AccountOwner,
-        /// Amount to be transferred
-        amount: Amount,
-        /// Target account to transfer the amount to
-        target_account: Account,
-    },
-    /// Same as `Transfer` but the source account may be remote. Depending on its
-    /// configuration, the target chain may take time or refuse to process
-    /// the message.
-    Claim {
-        /// Source account to claim amount from
-        source_account: Account,
-        /// Amount to be claimed
-        amount: Amount,
-        /// Target account to claim the amount into
-        target_account: Account,
-    },
-}
-
 /// Creates a fungible token application and distributes `initial_amounts` to new individual
 /// chains.
 #[cfg(all(any(test, feature = "test"), not(target_arch = "wasm32")))]
@@ -168,7 +99,7 @@ pub async fn create_with_accounts(
             .add_block(|block| {
                 block.with_operation(
                     application_id,
-                    Operation::Claim {
+                    FungibleOperation::Claim {
                         source_account: Account {
                             chain_id: token_chain.id(),
                             owner: *account,

examples/fungible/src/service.rs

@@ -8,8 +8,9 @@ mod state;
 use std::sync::Arc;
 
 use async_graphql::{EmptySubscription, Object, Request, Response, Schema};
-use fungible::{Operation, OwnerSpender, Parameters};
+use fungible::{OwnerSpender, Parameters};
 use linera_sdk::{
+    abis::fungible::FungibleOperation,
     graphql::GraphQLMutationRoot,
     linera_base_types::{AccountOwner, Amount, WithServiceAbi},
     views::{MapView, View},
@@ -46,7 +47,7 @@ impl Service for FungibleTokenService {
     async fn handle_query(&self, request: Request) -> Response {
         let schema = Schema::build(
             self.clone(),
-            Operation::mutation_root(self.runtime.clone()),
+            FungibleOperation::mutation_root(self.runtime.clone()),
             EmptySubscription,
         )
         .finish();

examples/fungible/tests/cross_chain.rs

@@ -5,10 +5,9 @@
 
 #![cfg(not(target_arch = "wasm32"))]
 
-use fungible::{
-    Account, FungibleTokenAbi, InitialState, InitialStateBuilder, Operation, Parameters,
-};
+use fungible::{Account, FungibleTokenAbi, InitialState, InitialStateBuilder, Parameters};
 use linera_sdk::{
+    abis::fungible::FungibleOperation,
     linera_base_types::{AccountOwner, Amount},
     test::{MessageAction, TestValidator},
 };
@@ -43,7 +42,7 @@ async fn test_cross_chain_transfer() {
         .add_block(|block| {
             block.with_operation(
                 application_id,
-                Operation::Transfer {
+                FungibleOperation::Transfer {
                     owner: sender_account,
                     amount: transfer_amount,
                     target_account: Account {
@@ -97,7 +96,7 @@ async fn test_bouncing_tokens() {
         .add_block(|block| {
             block.with_operation(
                 application_id,
-                Operation::Transfer {
+                FungibleOperation::Transfer {
                     owner: sender_account,
                     amount: transfer_amount,
                     target_account: Account {

examples/matching-engine/src/contract.rs

@@ -191,7 +191,7 @@ impl MatchingEngineContract {
         target_account: Account,
         token_idx: u32,
     ) {
-        let transfer = fungible::Operation::Transfer {
+        let transfer = fungible::FungibleOperation::Transfer {
             owner,
             amount,
             target_account,

examples/native-fungible/src/contract.rs

@@ -3,12 +3,14 @@
 
 #![cfg_attr(target_arch = "wasm32", no_main)]
 
-use fungible::{FungibleResponse, InitialState, Parameters};
 use linera_sdk::{
+    abis::fungible::{
+        FungibleResponse, InitialState, NativeFungibleOperation, NativeFungibleTokenAbi, Parameters,
+    },
     linera_base_types::{Account, AccountOwner, ChainId, WithContractAbi},
     Contract, ContractRuntime,
 };
-use native_fungible::{Message, NativeFungibleTokenAbi, Operation, TICKER_SYMBOL};
+use native_fungible::{Message, TICKER_SYMBOL};
 
 pub struct NativeFungibleTokenContract {
     runtime: ContractRuntime<Self>,
@@ -47,14 +49,16 @@ impl Contract for NativeFungibleTokenContract {
 
     async fn execute_operation(&mut self, operation: Self::Operation) -> Self::Response {
         match operation {
-            Operation::Balance { owner } => {
+            NativeFungibleOperation::Balance { owner } => {
                 let balance = self.runtime.owner_balance(owner);
                 FungibleResponse::Balance(balance)
             }
 
-            Operation::TickerSymbol => FungibleResponse::TickerSymbol(String::from(TICKER_SYMBOL)),
+            NativeFungibleOperation::TickerSymbol => {
+                FungibleResponse::TickerSymbol(String::from(TICKER_SYMBOL))
+            }
 
-            Operation::Transfer {
+            NativeFungibleOperation::Transfer {
                 owner,
                 amount,
                 target_account,
@@ -72,7 +76,7 @@ impl Contract for NativeFungibleTokenContract {
                 FungibleResponse::Ok
             }
 
-            Operation::Claim {
+            NativeFungibleOperation::Claim {
                 source_account,
                 amount,
                 target_account,