Contracts: Stabilize APIs (#3384)

Remove `#[unstable]` on `call_v2`, `instantiate_v2`,
`lock_delegate_dependency` and `unlock_delegate_dependency`.
See ink! integrations: 
- call_v2: use-ink/ink#2077
- instantiate_v2: <TODO>
- lock/unlock dependency: use-ink/ink#2076

Author: pgherveou

prdoc/pr_3384.prdoc

@@ -0,0 +1,14 @@
+# Schema: Polkadot SDK PRDoc Schema (prdoc) v1.0.0
+# See doc at https://raw.githubusercontent.com/paritytech/polkadot-sdk/master/prdoc/schema_user.json
+
+title: "[pallet_contracts] stabilize `call_v2`, `instantiate_v2`, `lock_dependency` and `unlock_dependency`"
+
+doc:
+  - audience: Runtime Dev
+    description: |
+      These APIs are currently unstable and are being stabilized in this PR.
+      Note: `add_delegate_dependency` and `remove_delegate_dependency` have been renamed to `lock_dependency` and `unlock_dependency` respectively.
+
+crates:
+  - name: pallet-contracts-uapi
+  - name: pallet-contracts

substrate/frame/contracts/fixtures/contracts/call.rs

@@ -35,11 +35,13 @@ pub extern "C" fn call() {
 	);
 
 	// Call the callee
-	api::call_v1(
+	api::call_v2(
 		uapi::CallFlags::empty(),
 		callee_addr,
-		0u64,                // How much gas to devote for the execution. 0 = all.
-		&0u64.to_le_bytes(), // value transferred to the contract.
+		0u64,                // How much ref_time to devote for the execution. 0 = all.
+		0u64,                // How much proof_size to devote for the execution. 0 = all.
+		None,                // No deposit limit.
+		&0u64.to_le_bytes(), // Value transferred to the contract.
 		callee_input,
 		None,
 	)

substrate/frame/contracts/fixtures/contracts/call_return_code.rs

@@ -38,11 +38,13 @@ pub extern "C" fn call() {
 	);
 
 	// Call the callee
-	let err_code = match api::call_v1(
+	let err_code = match api::call_v2(
 		uapi::CallFlags::empty(),
 		callee_addr,
-		0u64,                  // How much gas to devote for the execution. 0 = all.
-		&100u64.to_le_bytes(), // value transferred to the contract.
+		0u64,                  // How much ref_time to devote for the execution. 0 = all.
+		0u64,                  // How much proof_size to devote for the execution. 0 = all.
+		None,                  // No deposit limit.
+		&100u64.to_le_bytes(), // Value transferred to the contract.
 		input,
 		None,
 	) {

substrate/frame/contracts/fixtures/contracts/call_runtime_and_call.rs

@@ -39,11 +39,13 @@ pub extern "C" fn call() {
 	api::call_runtime(call).unwrap();
 
 	// Call the callee
-	api::call_v1(
+	api::call_v2(
 		uapi::CallFlags::empty(),
 		callee_addr,
-		0u64,                // How much gas to devote for the execution. 0 = all.
-		&0u64.to_le_bytes(), // value transferred to the contract.
+		0u64,                // How much ref_time to devote for the execution. 0 = all.
+		0u64,                // How much proof_size to devote for the execution. 0 = all.
+		None,                // No deposit limit.
+		&0u64.to_le_bytes(), // Value transferred to the contract.
 		callee_input,
 		None,
 	)

substrate/frame/contracts/fixtures/contracts/call_with_limit.rs

@@ -38,7 +38,6 @@ pub extern "C" fn call() {
 		forwarded_input: [u8],
 	);
 
-	#[allow(deprecated)]
 	api::call_v2(
 		uapi::CallFlags::empty(),
 		callee_addr,

substrate/frame/contracts/fixtures/contracts/caller_contract.rs

@@ -40,7 +40,6 @@ pub extern "C" fn call() {
 	let reverted_input = [1u8, 34, 51, 68, 85, 102, 119];
 
 	// Fail to deploy the contract since it returns a non-zero exit status.
-	#[allow(deprecated)]
 	let res = api::instantiate_v2(
 		code_hash,
 		0u64, // How much ref_time weight to devote for the execution. 0 = all.
@@ -55,7 +54,6 @@ pub extern "C" fn call() {
 	assert!(matches!(res, Err(ReturnErrorCode::CalleeReverted)));
 
 	// Fail to deploy the contract due to insufficient ref_time weight.
-	#[allow(deprecated)]
 	let res = api::instantiate_v2(
 		code_hash, 1u64, // too little ref_time weight
 		0u64, // How much proof_size weight to devote for the execution. 0 = all.
@@ -65,7 +63,6 @@ pub extern "C" fn call() {
 	assert!(matches!(res, Err(ReturnErrorCode::CalleeTrapped)));
 
 	// Fail to deploy the contract due to insufficient proof_size weight.
-	#[allow(deprecated)]
 	let res = api::instantiate_v2(
 		code_hash, 0u64, // How much ref_time weight to devote for the execution. 0 = all.
 		1u64, // Too little proof_size weight
@@ -78,7 +75,6 @@ pub extern "C" fn call() {
 	let mut callee = [0u8; 32];
 	let callee = &mut &mut callee[..];
 
-	#[allow(deprecated)]
 	api::instantiate_v2(
 		code_hash,
 		0u64, // How much ref_time weight to devote for the execution. 0 = all.
@@ -94,7 +90,6 @@ pub extern "C" fn call() {
 	assert_eq!(callee.len(), 32);
 
 	// Call the new contract and expect it to return failing exit code.
-	#[allow(deprecated)]
 	let res = api::call_v2(
 		uapi::CallFlags::empty(),
 		callee,
@@ -108,11 +103,10 @@ pub extern "C" fn call() {
 	assert!(matches!(res, Err(ReturnErrorCode::CalleeReverted)));
 
 	// Fail to call the contract due to insufficient ref_time weight.
-	#[allow(deprecated)]
 	let res = api::call_v2(
 		uapi::CallFlags::empty(),
 		callee,
-		1u64, // too little ref_time weight
+		1u64, // Too little ref_time weight.
 		0u64, // How much proof_size weight to devote for the execution. 0 = all.
 		None, // No deposit limit.
 		&value,
@@ -122,7 +116,6 @@ pub extern "C" fn call() {
 	assert!(matches!(res, Err(ReturnErrorCode::CalleeTrapped)));
 
 	// Fail to call the contract due to insufficient proof_size weight.
-	#[allow(deprecated)]
 	let res = api::call_v2(
 		uapi::CallFlags::empty(),
 		callee,
@@ -137,7 +130,6 @@ pub extern "C" fn call() {
 
 	// Call the contract successfully.
 	let mut output = [0u8; 4];
-	#[allow(deprecated)]
 	api::call_v2(
 		uapi::CallFlags::empty(),
 		callee,

substrate/frame/contracts/fixtures/contracts/chain_extension_temp_storage.rs

@@ -50,11 +50,13 @@ pub extern "C" fn call() {
 		output!(addr, [0u8; 32], api::address,);
 
 		// call self
-		api::call_v1(
+		api::call_v2(
 			uapi::CallFlags::ALLOW_REENTRY,
 			addr,
-			0u64,                // How much gas to devote for the execution. 0 = all.
-			&0u64.to_le_bytes(), // value transferred to the contract.
+			0u64,                // How much ref_time to devote for the execution. 0 = all.
+			0u64,                // How much proof_size to devote for the execution. 0 = all.
+			None,                // No deposit limit.
+			&0u64.to_le_bytes(), // Value transferred to the contract.
 			input,
 			None,
 		)

substrate/frame/contracts/fixtures/contracts/create_storage_and_call.rs

@@ -40,14 +40,13 @@ pub extern "C" fn call() {
 	api::set_storage(buffer, &[1u8; 4]);
 
 	// Call the callee
-	#[allow(deprecated)]
 	api::call_v2(
 		uapi::CallFlags::empty(),
 		callee,
 		0u64, // How much ref_time weight to devote for the execution. 0 = all.
 		0u64, // How much proof_size weight to devote for the execution. 0 = all.
 		Some(deposit_limit),
-		&0u64.to_le_bytes(), // value transferred to the contract.
+		&0u64.to_le_bytes(), // Value transferred to the contract.
 		input,
 		None,
 	)

substrate/frame/contracts/fixtures/contracts/create_storage_and_instantiate.rs

@@ -40,7 +40,6 @@ pub extern "C" fn call() {
 	let mut address = [0u8; 32];
 	let address = &mut &mut address[..];
 
-	#[allow(deprecated)]
 	api::instantiate_v2(
 		code_hash,
 		0u64, // How much ref_time weight to devote for the execution. 0 = all.

substrate/frame/contracts/fixtures/contracts/destroy_and_transfer.rs

@@ -34,7 +34,6 @@ pub extern "C" fn deploy() {
 	let address = &mut &mut address[..];
 	let salt = [71u8, 17u8];
 
-	#[allow(deprecated)]
 	api::instantiate_v2(
 		code_hash,
 		0u64, // How much ref_time weight to devote for the execution. 0 = all.
@@ -60,7 +59,6 @@ pub extern "C" fn call() {
 	api::get_storage(&ADDRESS_KEY, callee_addr).unwrap();
 
 	// Calling the destination contract with non-empty input data should fail.
-	#[allow(deprecated)]
 	let res = api::call_v2(
 		uapi::CallFlags::empty(),
 		callee_addr,
@@ -74,7 +72,6 @@ pub extern "C" fn call() {
 	assert!(matches!(res, Err(uapi::ReturnErrorCode::CalleeTrapped)));
 
 	// Call the destination contract regularly, forcing it to self-destruct.
-	#[allow(deprecated)]
 	api::call_v2(
 		uapi::CallFlags::empty(),
 		callee_addr,