Skip to content
This repository has been archived by the owner on Aug 21, 2024. It is now read-only.

Update Futurenet to Testnet Across Documentation #577

Merged
merged 24 commits into from
Sep 22, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
24 commits
Select commit Hold shift + click to select a range
8f9f33a
Futurenet -> Testnet
Julian-dev28 Sep 20, 2023
50c12ca
fix broken links
Julian-dev28 Sep 20, 2023
0e04985
update-rpc-page
Julian-dev28 Sep 20, 2023
7cf22da
Update testnet.mdx
Julian-dev28 Sep 20, 2023
8287d73
Pass 1
Julian-dev28 Sep 21, 2023
d81b145
format
Julian-dev28 Sep 21, 2023
8120b49
update table in testnet.mdx
Julian-dev28 Sep 21, 2023
8172eef
update state expiration example script to use testnet
ElliotFriend Sep 21, 2023
218e8d5
replacing futurenet with testnet in contract deployment example
ElliotFriend Sep 21, 2023
e7f789a
revert SDC contnet
Julian-dev28 Sep 21, 2023
7fcfa82
Merge remote-tracking branch 'upstream/main' into replace-futurenet-r…
ElliotFriend Sep 21, 2023
cbceec6
Merge branch 'replace-futurenet-references' of github.com:stellar/sor…
ElliotFriend Sep 21, 2023
0d8cc4c
include testnet network passphrase on releases page
ElliotFriend Sep 21, 2023
d15ed21
update freighter to include testnet alongside futurenet
ElliotFriend Sep 21, 2023
1a84c42
revert SDC to Use Futurenet for the time being
Julian-dev28 Sep 21, 2023
df756d8
style: fix up markdown syntax and style in `rpc.mdx`
ElliotFriend Sep 22, 2023
2f9560a
Merge branch 'main' of github.com:stellar/soroban-docs into replace-f…
ElliotFriend Sep 22, 2023
48dfa65
docs: include Testnet when describing what RPC servers SDF maintains
ElliotFriend Sep 22, 2023
9a8b7ba
style: changing a single ellipsis character with three periods
ElliotFriend Sep 22, 2023
14e2b22
docs: include gh repo links to the software that runs in quickstart
ElliotFriend Sep 22, 2023
c746d45
add the Testnet network to the example `initialize.sh` script
ElliotFriend Sep 22, 2023
049c797
change contract-invoking transaction example code to use Testnet
ElliotFriend Sep 22, 2023
bc05850
change to valid futurenet URLs in dapp challenges
ElliotFriend Sep 22, 2023
444823b
Apply suggestions from code review
ElliotFriend Sep 22, 2023
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion api/methods/getLedgerEntries.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -390,4 +390,4 @@ And the response we get contains (even more) `LedgerEntryData` that we can decod
```

[`increment` example contract]: /docs/getting-started/storing-data
["View XDR" page of the Stellar Laboratory]: <https://laboratory.stellar.org/#xdr-viewer?type=LedgerEntryData&network=futurenet>
["View XDR" page of the Stellar Laboratory]: <https://laboratory.stellar.org/#xdr-viewer?type=LedgerEntryData&network=testnet>
4 changes: 2 additions & 2 deletions api/methods/getNetwork.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -30,8 +30,8 @@ General info about the currently configured network.
"jsonrpc": "2.0",
"id": 8675309,
"result": {
"friendbotUrl": "https://friendbot-futurenet.stellar.org/",
"passphrase": "Test SDF Future Network ; October 2022",
"friendbotUrl": "https://friendbot.stellar.org/",
"passphrase": "Test SDF Network ; September 2015",
"protocolVersion": "20"
}
}
Expand Down
2 changes: 1 addition & 1 deletion dapps/dapp-challenges/challenge-1-payment.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -267,7 +267,7 @@ Once the deployment is complete, you should see something similar to the followi

You can now visit the preview link to see your deployed dapp! 🎉

You will need to add some Futurenet network lumens to your Freighter wallet to interact with the deployed dapp. Visit [https://laboratory.stellar.org/#create-account](https://laboratory.stellar.org/#create-account), and follow the instructions to create your Freighter account on Futurenet.7
You will need to add some Futurenet network lumens to your Freighter wallet to interact with the deployed dapp. Visit [https://laboratory.stellar.org/#create-account](https://laboratory.stellar.org/#create-account), and follow the instructions to create your Freighter account on Futurenet.

## Checkpoint 7: ✅ Complete the Challenge!

Expand Down
12 changes: 9 additions & 3 deletions dapps/guides/initialization.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -115,21 +115,27 @@ else
SOROBAN_RPC_HOST="http://localhost:8000"
fi

SOROBAN_RPC_URL="https://rpc-futurenet.stellar.org"

case "$1" in
standalone)
echo "Using standalone network"
SOROBAN_NETWORK_PASSPHRASE="Standalone Network ; February 2017"
FRIENDBOT_URL="$SOROBAN_RPC_HOST/friendbot"
SOROBAN_RPC_URL="$SOROBAN_RPC_HOST/soroban/rpc"
;;
futurenet)
echo "Using Futurenet network"
SOROBAN_NETWORK_PASSPHRASE="Test SDF Future Network ; October 2022"
FRIENDBOT_URL="https://friendbot-futurenet.stellar.org/"
SOROBAN_RPC_URL="https://rpc-futurenet.stellar.org"
;;
testnet)
echo "Using Testnet network"
SOROBAN_NETWORK_PASSPHRASE="Test SDF Network ; September 2015"
FRIENDBOT_URL="https://friendbot.stellar.org/"
SOROBAN_RPC_URL="https://soroban-testnet.stellar.org"
;;
*)
echo "Usage: $0 standalone|futurenet"
echo "Usage: $0 standalone|futurenet|testnet"
exit 1
;;
esac
Expand Down
2 changes: 1 addition & 1 deletion dapps/guides/react.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ Below is a list of the libraries used throughout the frontend code and their res

```jsx
import { SorobanReactProvider } from "@soroban-react/core";
import { futurenet, sandbox, standalone } from "@soroban-react/chains";
import { testnet, sandbox, standalone } from "@soroban-react/chains";
import { freighter } from "@soroban-react/freighter";
import { ChainMetadata, Connector } from "@soroban-react/types";
import type {
Expand Down
2 changes: 1 addition & 1 deletion dapps/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ This course operates within the pre-release version of Soroban. Expect breaking

While the course specifically focuses on the Soroban platform, the knowledge you gain can be applied to other transaction processors such as different blockchains, L2s, and permissioned ledgers. The skills you acquire here are meant to be transferable and versatile.

Through The Soroban Dapps Challenge, you'll have hands-on experience using Soroban's initial versions of the smart contracts environment, a Rust SDK, a CLI, and an RPC server. You'll learn how to write, test, and deploy smart contracts, and you'll get to see your code in action on our special test network, Futurenet.
Through The Soroban Dapps Challenge, you'll have hands-on experience using Soroban's initial versions of the smart contracts environment, a Rust SDK, a CLI, and an RPC server. You'll learn how to write, test, and deploy smart contracts, and you'll get to see your code in action on Futurenet.

# What this course entails

Expand Down
2 changes: 1 addition & 1 deletion docs/advanced-tutorials/liquidity-pool.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -533,7 +533,7 @@ fn initialize(e: Env, token_wasm_hash: BytesN<32>, taken_a: Address, token_b: Ad
[creating its own `POOL` token]: #creating-a-custom-token-for-lp-shares
[interacting with contracts for `token_a` and `token_b`]: #token-transfers-tofrom-the-lp-contract
[`token` example contract]: ./tokens
[installed]: ../getting-started/deploy-to-futurenet#two-step-deployment
[installed]: ../getting-started/deploy-to-testnet#two-step-deployment
[lexicographical order]: https://developers.stellar.org/docs/encyclopedia/liquidity-on-stellar-sdex-liquidity-pools#liquidity-pool-participation

### A "Constant Product" Liquidity Pool
Expand Down
2 changes: 1 addition & 1 deletion docs/basic-tutorials/deployer.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -133,7 +133,7 @@ as well.

See the [tests](#tests) for an example of uploading the contract code
programmatically. For the actual on-chain installation see the general deployment
[tutorial](https://soroban.stellar.org/docs/getting-started/deploy-to-futurenet).
[tutorial](https://soroban.stellar.org/docs/getting-started/deploy-to-testnet).

### Authorization

Expand Down
6 changes: 3 additions & 3 deletions docs/fundamentals-and-concepts/fees-and-metering.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -60,7 +60,7 @@ The implementation details for fee computation are provided by the following [li

The best way to find the required fees for any Soroban transaction is to use the transaction simulation with [preflight service](./interacting-with-contracts.mdx#preflight).

The fee rates are currently defined for the Futurenet as follows:
The fee rates are currently defined for the Testnet as follows:

| Description | Cost (stroops) |
| --------------------------------- | -------------------- |
Expand All @@ -77,7 +77,7 @@ The fee rates are currently defined for the Futurenet as follows:
| Temp entry rent coefficient | 10 months in ledgers |
| Persistent entry rent coefficient | 1 month in ledgers |

Note, that write fees grow linearly from empty ledger to 2 GB (ledger "target size"), and then grow linearly, but with a 1000x factor after exceeding the target. This is to bound the ledger size growth. As Futurenet is a small, test network, the target size is set to just 2 GB.
Note, that write fees grow linearly from empty ledger to 2 GB (ledger "target size"), and then grow linearly, but with a 1000x factor after exceeding the target. This is to bound the ledger size growth. As Testnet is a small, test network, the target size is set to just 2 GB.

One ledger worth of rent costs `write_fee / rent_coefficient`, where `write_fee` is the cost of writing the ledger entry and `rent_coefficient` is a number of ledgers for which the whole write fee will be paid. Given the numbers above, this means that 1 month of renting the ledger space for the temporary entry costs `write_fee / 10` and it costs `write_fee` for a persistent entry (10x more).

Expand All @@ -91,7 +91,7 @@ Ledger close time is constrained to a few seconds, thus preventing the execution

These resource limits may change in the Mainnet release. They can also be updated, usually increased, based on the network validator vote and consensus.

The current (Futurenet) limits are as follows:
The current (Testnet) limits are as follows:

| Resource | Limit |
| -------------------------- | ----------- |
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -63,7 +63,7 @@ npm install --save soroban-client

// Configure SorobanClient to use the `soroban-rpc` instance of your
// choosing.
const server = new Server("https://rpc-futurenet.stellar.org:443");
const server = new Server("https://soroban-testnet.stellar.org:443");

// Here we will use a deployed instance of the `increment` example contract.
const contractAddress =
Expand All @@ -78,7 +78,7 @@ npm install --save soroban-client
// fee, and network passphrase are provided.
let builtTransaction = new TransactionBuilder(sourceAccount, {
fee: BASE_FEE,
networkPassphrase: Networks.FUTURENET,
networkPassphrase: Networks.TESTNET,
})
// The invocation of the `increment` function of our contract is added
// to the transaction. Note: `increment` doesn't require any parameters,
Expand Down Expand Up @@ -172,7 +172,7 @@ from stellar_sdk.soroban_rpc import GetTransactionStatus, SendTransactionStatus
source_keypair = Keypair.from_secret('SCQN3XGRO65BHNSWLSHYIR4B65AHLDUQ7YLHGIWQ4677AZFRS77TCZRB')

# Configure SorobanClient to use the `soroban-rpc` instance of your choosing.
soroban_server = SorobanServer('https://rpc-futurenet.stellar.org')
soroban_server = SorobanServer('https://soroban-testnet.stellar.org')

# Here we will use a deployed instance of the `increment` example contract.
contract_address = 'CBEOJUP5FU6KKOEZ7RMTSKZ7YLBS5D6LVATIGCESOGXSZEQ2UWQFKZW6'
Expand All @@ -187,7 +187,7 @@ built_transaction = (
TransactionBuilder(
source_account=source_account,
base_fee=100,
network_passphrase=Network.FUTURENET_NETWORK_PASSPHRASE,
network_passphrase=Network.TESTNET_NETWORK_PASSPHRASE,
)
# The invocation of the `increment` function of our contract is added to the
# transaction. Note: `increment` doesn't require any parameters, but many
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -104,8 +104,8 @@ from stellar_sdk.soroban.soroban_rpc import TransactionStatus

# TODO: You need to replace the following parameters according to the actual situation
secret = "SAAPYAPTTRZMCUZFPG3G66V4ZMHTK4TWA6NS7U4F7Z3IMUD52EK4DDEV"
rpc_server_url = "http://127.0.0.1:8000/soroban/rpc"
network_passphrase = Network.FUTURENET_NETWORK_PASSPHRASE
rpc_server_url = "https://soroban-testnet.stellar.org"
network_passphrase = Network.TESTNET_NETWORK_PASSPHRASE
contract_file_path = "/path/to/compiled/soroban_contract.wasm"

kp = Keypair.from_secret(secret)
Expand Down Expand Up @@ -921,7 +921,7 @@ test test::test ... ok

Now that we have a working vault contract, we can deploy it to a network and interact with it.

This section requires you to have a funded Keypair to use with Stellar's Futurenet. You can create and fund one using the [Stellar Laboratory](https://laboratory.stellar.org/#account-creator?network=futurenet).
This section requires you to have a funded Keypair to use with Stellar's Testnet. You can create and fund one using the [Stellar Laboratory](https://laboratory.stellar.org/#account-creator?network=testnet).

Below you will find a series of commands that will help you build, deploy and interact with the vault and token contracts. You can use them to follow along as we walk through the process of building, deploying, and interacting with the contracts. It may behoove you to keep these commands in a `scripts` directory in your project. This way, you can easily run them from your terminal.

Expand All @@ -942,8 +942,8 @@ soroban contract build
soroban contract deploy \
--wasm soroban_token_contract.wasm \
--source <SECRET_KEY> \
--rpc-url https://rpc-futurenet.stellar.org:443 \
--network-passphrase 'Test SDF Future Network ; October 2022'
--rpc-url https://soroban-testnet.stellar.org:443 \
--network-passphrase 'Test SDF Network ; September 2015'
```

</TabItem>
Expand All @@ -955,8 +955,8 @@ soroban contract invoke \
--wasm soroban_token_contract.wasm \
--id <TOKEN_CONTRACT_ID> \
--source <SECRET_KEY> \
--rpc-url https://rpc-futurenet.stellar.org:443 \
--network-passphrase 'Test SDF Future Network ; October 2022' \
--rpc-url https://soroban-testnet.stellar.org:443 \
--network-passphrase 'Test SDF Network ; September 2015' \
-- \
initialize \
--admin <USER_ADDRESS> \
Expand All @@ -974,8 +974,8 @@ soroban contract invoke \
--wasm soroban_token_contract.wasm \
--id <TOKEN_CONTRACT_ID> \
--source <SECRET_KEY> \
--rpc-url https://rpc-futurenet.stellar.org:443 \
--network-passphrase 'Test SDF Future Network ; October 2022' \
--rpc-url https://soroban-testnet.stellar.org:443 \
--network-passphrase 'Test SDF Network ; September 2015' \
-- \
mint \
--to <USER_OR_VAULT_ADDRESS> \
Expand All @@ -991,8 +991,8 @@ soroban contract invoke \
--wasm soroban_token_contract.wasm \
--id <TOKEN_CONTRACT_ID> \
--source <SECRET_KEY> \
--rpc-url https://rpc-futurenet.stellar.org:443 \
--network-passphrase 'Test SDF Future Network ; October 2022' \
--rpc-url https://soroban-testnet.stellar.org:443 \
--network-passphrase 'Test SDF Network ; September 2015' \
-- \
balance \
--id <USER_OR_VAULT_ADDRESS>
Expand All @@ -1014,8 +1014,8 @@ soroban contract install --wasm soroban_token_contract.wasm
soroban contract deploy \
--wasm target/wasm32-unknown-unknown/release/vault.wasm \
--source <SECRET_KEY> \
--rpc-url https://rpc-futurenet.stellar.org:443 \
--network-passphrase 'Test SDF Future Network ; October 2022'
--rpc-url https://soroban-testnet.stellar.org:443 \
--network-passphrase 'Test SDF Network ; September 2015'
```

</TabItem>
Expand All @@ -1027,8 +1027,8 @@ soroban contract invoke \
--wasm target/wasm32-unknown-unknown/release/vault.wasm \
--id <VAULT_CONTRACT_ID> \
--source <SECRET_KEY> \
--rpc-url https://rpc-futurenet.stellar.org:443 \
--network-passphrase 'Test SDF Future Network ; October 2022' \
--rpc-url https://soroban-testnet.stellar.org:443 \
--network-passphrase 'Test SDF Network ; September 2015' \
-- \
initialize \
--token_wasm_hash 73593275ee3bcacc2aef8d641a1d5108618064bdfff84a826576b8caff395add \
Expand All @@ -1044,8 +1044,8 @@ soroban contract invoke \
--wasm target/wasm32-unknown-unknown/release/vault.wasm \
--id <VAULT_CONTRACT_ID> \
--source <SECRET_KEY> \
--rpc-url https://rpc-futurenet.stellar.org:443 \
--network-passphrase 'Test SDF Future Network ; October 2022' \
--rpc-url https://soroban-testnet.stellar.org:443 \
--network-passphrase 'Test SDF Network ; September 2015' \
-- \
share_id
```
Expand All @@ -1059,8 +1059,8 @@ soroban contract invoke \
--wasm target/wasm32-unknown-unknown/release/vault.wasm \
--id <VAULT_CONTRACT_ID> \
--source <SECRET_KEY> \
--rpc-url https://rpc-futurenet.stellar.org:443 \
--network-passphrase 'Test SDF Future Network ; October 2022' \
--rpc-url https://soroban-testnet.stellar.org:443 \
--network-passphrase 'Test SDF Network ; September 2015' \
-- \
deposit \
--from <USER_ADDRESS> \
Expand All @@ -1076,8 +1076,8 @@ soroban contract invoke \
--wasm target/wasm32-unknown-unknown/release/vault.wasm \
--id <VAULT_CONTRACT_ID> \
--source <SECRET_KEY> \
--rpc-url https://rpc-futurenet.stellar.org:443 \
--network-passphrase 'Test SDF Future Network ; October 2022' \
--rpc-url https://soroban-testnet.stellar.org:443 \
--network-passphrase 'Test SDF Network ; September 2015' \
-- \
get_rsrvs
```
Expand All @@ -1091,8 +1091,8 @@ soroban contract invoke \
--wasm target/wasm32-unknown-unknown/release/vault.wasm \
--id <VAULT_CONTRACT_ID> \
--source <SECRET_KEY> \
--rpc-url https://rpc-futurenet.stellar.org:443 \
--network-passphrase 'Test SDF Future Network ; October 2022' \
--rpc-url https://soroban-testnet.stellar.org:443 \
--network-passphrase 'Test SDF Network ; September 2015' \
-- \
withdraw \
--to <USER_ADDRESS> \
Expand All @@ -1116,8 +1116,8 @@ Next, we need to deploy the token contract. We can do this by running the `deplo
soroban contract deploy \
--wasm soroban_token_contract.wasm \
--source <SECRET_KEY> \
--rpc-url https://rpc-futurenet.stellar.org:443 \
--network-passphrase 'Test SDF Future Network ; October 2022'
--rpc-url https://soroban-testnet.stellar.org:443 \
--network-passphrase 'Test SDF Network ; September 2015'
```

We should receive an output with the token contract ID. We will need this ID for the next step.
Expand All @@ -1141,8 +1141,8 @@ soroban contract invoke \
--wasm soroban_token_contract.wasm \
--id <TOKEN_CONTRACT_ID> \
--source <SECRET_KEY> \
--rpc-url https://rpc-futurenet.stellar.org:443 \
--network-passphrase 'Test SDF Future Network ; October 2022' \
--rpc-url https://soroban-testnet.stellar.org:443 \
--network-passphrase 'Test SDF Network ; September 2015' \
-- \
initialize \
--admin <USER_ADDRESS> \
Expand All @@ -1157,8 +1157,8 @@ Next, we need to deploy the vault contract. We can do this by running the `deplo
soroban contract deploy \
--wasm target/wasm32-unknown-unknown/release/vault.wasm \
--source <SECRET_KEY> \
--rpc-url https://rpc-futurenet.stellar.org:443 \
--network-passphrase 'Test SDF Future Network ; October 2022'
--rpc-url https://soroban-testnet.stellar.org:443 \
--network-passphrase 'Test SDF Network ; September 2015'
```

We should receive an output with the vault contract ID. We will need this ID for the next step.
Expand Down Expand Up @@ -1212,8 +1212,8 @@ soroban contract invoke \
--wasm target/wasm32-unknown-unknown/release/vault.wasm \
--id <VAULT_CONTRACT_ID> \
--source <SECRET_KEY> \
--rpc-url https://rpc-futurenet.stellar.org:443 \
--network-passphrase 'Test SDF Future Network ; October 2022' \
--rpc-url https://soroban-testnet.stellar.org:443 \
--network-passphrase 'Test SDF Network ; September 2015' \
-- \
initialize \
--token_wasm_hash 73593275ee3bcacc2aef8d641a1d5108618064bdfff84a826576b8caff395add \
Expand Down Expand Up @@ -1245,8 +1245,8 @@ soroban contract invoke \
--wasm soroban_token_contract.wasm \
--id <TOKEN_CONTRACT_ID> \
--source <SECRET_KEY> \
--rpc-url https://rpc-futurenet.stellar.org:443 \
--network-passphrase 'Test SDF Future Network ; October 2022' \
--rpc-url https://soroban-testnet.stellar.org:443 \
--network-passphrase 'Test SDF Network ; September 2015' \
-- \
mint \
--to <USER_OR_VAULT_ADDRESS> \
Expand All @@ -1260,8 +1260,8 @@ soroban contract invoke \
--wasm soroban_token_contract.wasm \
--id <TOKEN_CONTRACT_ID> \
--source <SECRET_KEY> \
--rpc-url https://rpc-futurenet.stellar.org:443 \
--network-passphrase 'Test SDF Future Network ; October 2022' \
--rpc-url https://soroban-testnet.stellar.org:443 \
--network-passphrase 'Test SDF Network ; September 2015' \
-- \
balance \
--id <USER_ADDRESS>
Expand All @@ -1280,8 +1280,8 @@ soroban contract invoke \
--wasm target/wasm32-unknown-unknown/release/vault.wasm \
--id <VAULT_CONTRACT_ID> \
--source <ACCOUNT_SECRET_KEY> \
--rpc-url https://rpc-futurenet.stellar.org:443 \
--network-passphrase 'Test SDF Future Network ; October 2022' \
--rpc-url https://soroban-testnet.stellar.org:443 \
--network-passphrase 'Test SDF Network ; September 2015' \
-- \
deposit \
--from <USER_ADDRESS> \
Expand All @@ -1295,8 +1295,8 @@ soroban contract invoke \
--wasm target/wasm32-unknown-unknown/release/vault.wasm \
--id <VAULT_CONTRACT_ID> \
--source <SECRET_KEY> \
--rpc-url https://rpc-futurenet.stellar.org:443 \
--network-passphrase 'Test SDF Future Network ; October 2022' \
--rpc-url https://soroban-testnet.stellar.org:443 \
--network-passphrase 'Test SDF Network ; September 2015' \
-- \
get_rsrvs
```
Expand All @@ -1316,8 +1316,8 @@ soroban contract invoke \
--wasm target/wasm32-unknown-unknown/release/vault.wasm \
--id <VAULT_CONTRACT_ID> \
--source <SECRET_KEY> \
--rpc-url https://rpc-futurenet.stellar.org:443 \
--network-passphrase 'Test SDF Future Network ; October 2022' \
--rpc-url https://soroban-testnet.stellar.org:443 \
--network-passphrase 'Test SDF Network ; September 2015' \
-- \
withdraw \
--to <USER_ADDRESS> \
Expand Down
Loading