ADDED: AddressResource + method stubs

src/api/AddressesResource.java

@@ -0,0 +1,318 @@
+package api;
+
+import data.block.BlockData;
+import globalization.Translator;
+import io.swagger.v3.oas.annotations.OpenAPIDefinition;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.extensions.Extension;
+import io.swagger.v3.oas.annotations.extensions.ExtensionProperty;
+import io.swagger.v3.oas.annotations.media.Content;
+import io.swagger.v3.oas.annotations.media.Schema;
+import io.swagger.v3.oas.annotations.responses.ApiResponse;
+import javax.servlet.http.HttpServletRequest;
+import javax.ws.rs.GET;
+import javax.ws.rs.Path;
+import javax.ws.rs.PathParam;
+import javax.ws.rs.Produces;
+import javax.ws.rs.core.Context;
+import javax.ws.rs.core.MediaType;
+
+@Path("addresses")
+@Produces({MediaType.APPLICATION_JSON, MediaType.TEXT_PLAIN})
+@OpenAPIDefinition(
+	extensions = @Extension(name = "translation", properties = {
+		@ExtensionProperty(name="path", value="/Api/AddressesResource")
+	})
+)
+public class AddressesResource {
+
+	@Context
+	HttpServletRequest request;
+	
+	private ApiErrorFactory apiErrorFactory;
+
+	public AddressesResource() {
+		this(new ApiErrorFactory(Translator.getInstance()));
+	}
+
+	public AddressesResource(ApiErrorFactory apiErrorFactory) {
+		this.apiErrorFactory = apiErrorFactory;
+	}
+
+	@GET
+	@Path("/lastreference/{address}")
+	@Operation(
+		description = "Returns the 64-byte long base58-encoded signature of last transaction where the address is delivered as creator. Or the first incoming transaction. Returns \"false\" if there is no transactions.",
+		extensions = {
+			@Extension(name = "translation", properties = {
+				@ExtensionProperty(name="path", value="GET lastreference:address"),
+				@ExtensionProperty(name="description.key", value="operation:description")
+			}),
+			@Extension(properties = {
+				@ExtensionProperty(name="apiErrors", value="[\"INVALID_ADDRESS\"]", parseValue = true),
+			})
+		},
+		responses = {
+			@ApiResponse(
+				description = "the base58-encoded transaction signature",
+				content = @Content(schema = @Schema(implementation = String.class)),
+				extensions = {
+					@Extension(name = "translation", properties = {
+						@ExtensionProperty(name="description.key", value="success_response:description")
+					})
+				}
+			)
+		}
+	)
+	public String getLastReference(@PathParam("address") String address) {
+		Security.checkApiCallAllowed("GET addresses/lastreference", request);
+
+		throw new UnsupportedOperationException();
+	}
+	
+	@GET
+	@Path("/lastreference/{address}/unconfirmed")
+	@Operation(
+		description = "Returns the 64-byte long base58-encoded signature of last transaction including unconfirmed where the address is delivered as creator. Or the first incoming transaction. Returns \\\"false\\\" if there is no transactions.",
+		extensions = {
+			@Extension(name = "translation", properties = {
+				@ExtensionProperty(name="path", value="GET lastreference:address:unconfirmed"),
+				@ExtensionProperty(name="description.key", value="operation:description")
+			}),
+			@Extension(properties = {
+				@ExtensionProperty(name="apiErrors", value="[\"INVALID_ADDRESS\"]", parseValue = true),
+			})
+		},
+		responses = {
+			@ApiResponse(
+				description = "the base58-encoded transaction signature",
+				content = @Content(schema = @Schema(implementation = String.class)),
+				extensions = {
+					@Extension(name = "translation", properties = {
+						@ExtensionProperty(name="description.key", value="success_response:description")
+					})
+				}
+			)
+		}
+	)
+	public String getLastReferenceUnconfirmed(@PathParam("address") String address) {
+		Security.checkApiCallAllowed("GET addresses/lastreference", request);
+
+		throw new UnsupportedOperationException();
+	}
+
+	@GET
+	@Path("/validate/{address}")
+	@Operation(
+		description = "Validates the given address. Returns true/false.",
+		extensions = {
+			@Extension(name = "translation", properties = {
+				@ExtensionProperty(name="path", value="GET validate:address"),
+				@ExtensionProperty(name="description.key", value="operation:description")
+			})
+		},
+		responses = {
+			@ApiResponse(
+				//description = "",
+				content = @Content(schema = @Schema(implementation = String.class)),
+				extensions = {
+					@Extension(name = "translation", properties = {
+						@ExtensionProperty(name="description.key", value="success_response:description")
+					})
+				}
+			)
+		}
+	)
+	public String validate(@PathParam("address") String address) {
+		Security.checkApiCallAllowed("GET addresses/validate", request);
+
+		throw new UnsupportedOperationException();
+	}
+	
+	@GET
+	@Path("/generatingbalance/{address}")
+	@Operation(
+		description = "Return the generating balance of the given address.",
+		extensions = {
+			@Extension(name = "translation", properties = {
+				@ExtensionProperty(name="path", value="GET generatingbalance:address"),
+				@ExtensionProperty(name="description.key", value="operation:description")
+			}),
+			@Extension(properties = {
+				@ExtensionProperty(name="apiErrors", value="[\"INVALID_ADDRESS\"]", parseValue = true),
+			})
+		},
+		responses = {
+			@ApiResponse(
+				description = "the generating balance",
+				content = @Content(schema = @Schema(implementation = String.class)),
+				extensions = {
+					@Extension(name = "translation", properties = {
+						@ExtensionProperty(name="description.key", value="success_response:description")
+					})
+				}
+			)
+		}
+	)
+	public String getGeneratingBalanceOfAddress(@PathParam("address") String address) {
+		Security.checkApiCallAllowed("GET addresses/generatingbalance", request);
+		
+		throw new UnsupportedOperationException();
+	}
+
+	@GET
+	@Path("balance/{address}")
+	@Operation(
+		description = "Returns the confirmed balance of the given address.",
+		extensions = {
+			@Extension(name = "translation", properties = {
+				@ExtensionProperty(name="path", value="GET balance:address"),
+				@ExtensionProperty(name="description.key", value="operation:description")
+			}),
+			@Extension(properties = {
+				@ExtensionProperty(name="apiErrors", value="[\"INVALID_ADDRESS\"]", parseValue = true),
+			})
+		},
+		responses = {
+			@ApiResponse(
+				description = "the balance",
+				content = @Content(schema = @Schema(implementation = String.class)),
+				extensions = {
+					@Extension(name = "translation", properties = {
+						@ExtensionProperty(name="description.key", value="success_response:description")
+					})
+				}
+			)
+		}
+	)
+	public String getGeneratingBalance(@PathParam("address") String address) {
+		Security.checkApiCallAllowed("GET addresses/balance", request);
+		
+		throw new UnsupportedOperationException();
+	}
+
+	@GET
+	@Path("assetbalance/{assetid}/{address}")
+	@Operation(
+		description = "Returns the confirmed balance of the given address for the given asset key.",
+		extensions = {
+			@Extension(name = "translation", properties = {
+				@ExtensionProperty(name="path", value="GET assetbalance:assetid:address"),
+				@ExtensionProperty(name="description.key", value="operation:description")
+			}),
+			@Extension(properties = {
+				@ExtensionProperty(name="apiErrors", value="[\"INVALID_ADDRESS\", \"INVALID_ASSET_ID\"]", parseValue = true),
+			})
+		},
+		responses = {
+			@ApiResponse(
+				description = "the balance",
+				content = @Content(schema = @Schema(implementation = String.class)),
+				extensions = {
+					@Extension(name = "translation", properties = {
+						@ExtensionProperty(name="description.key", value="success_response:description")
+					})
+				}
+			)
+		}
+	)
+	public String getAssetBalance(@PathParam("assetid") String assetid, @PathParam("address") String address) {
+		Security.checkApiCallAllowed("GET addresses/assetbalance", request);
+		
+		throw new UnsupportedOperationException();
+	}
+
+	@GET
+	@Path("assets/{address}")
+	@Operation(
+		description = "Returns the list of assets for this address with balances.",
+		extensions = {
+			@Extension(name = "translation", properties = {
+				@ExtensionProperty(name="path", value="GET assets:address"),
+				@ExtensionProperty(name="description.key", value="operation:description")
+			}),
+			@Extension(properties = {
+				@ExtensionProperty(name="apiErrors", value="[\"INVALID_ADDRESS\"]", parseValue = true),
+			})
+		},
+		responses = {
+			@ApiResponse(
+				description = "the list of assets",
+				content = @Content(schema = @Schema(implementation = String.class)),
+				extensions = {
+					@Extension(name = "translation", properties = {
+						@ExtensionProperty(name="description.key", value="success_response:description")
+					})
+				}
+			)
+		}
+	)
+	public String getAssetBalance(@PathParam("address") String address) {
+		Security.checkApiCallAllowed("GET addresses/assets", request);
+		
+		throw new UnsupportedOperationException();
+	}
+
+	@GET
+	@Path("balance/{address}/{confirmations}")
+	@Operation(
+		description = "Calculates the balance of the given address after the given confirmations.",
+		extensions = {
+			@Extension(name = "translation", properties = {
+				@ExtensionProperty(name="path", value="GET balance:address:confirmations"),
+				@ExtensionProperty(name="description.key", value="operation:description")
+			}),
+			@Extension(properties = {
+				@ExtensionProperty(name="apiErrors", value="[\"INVALID_ADDRESS\"]", parseValue = true),
+			})
+		},
+		responses = {
+			@ApiResponse(
+				description = "the balance",
+				content = @Content(schema = @Schema(implementation = String.class)),
+				extensions = {
+					@Extension(name = "translation", properties = {
+						@ExtensionProperty(name="description.key", value="success_response:description")
+					})
+				}
+			)
+		}
+	)
+	public String getGeneratingBalance(@PathParam("address") String address, @PathParam("confirmations") int confirmations) {
+		Security.checkApiCallAllowed("GET addresses/balance", request);
+		
+		throw new UnsupportedOperationException();
+	}
+
+	@GET
+	@Path("/publickey/{address}")
+	@Operation(
+		description = "Returns the 32-byte long base58-encoded account publickey of the given address.",
+		extensions = {
+			@Extension(name = "translation", properties = {
+				@ExtensionProperty(name="path", value="GET publickey:address"),
+				@ExtensionProperty(name="description.key", value="operation:description")
+			}),
+			@Extension(properties = {
+				@ExtensionProperty(name="apiErrors", value="[\"INVALID_ADDRESS\"]", parseValue = true),
+			})
+		},
+		responses = {
+			@ApiResponse(
+				description = "the publickey",
+				content = @Content(schema = @Schema(implementation = String.class)),
+				extensions = {
+					@Extension(name = "translation", properties = {
+						@ExtensionProperty(name="description.key", value="success_response:description")
+					})
+				}
+			)
+		}
+	)
+	public String getPublicKey(@PathParam("address") String address) {
+		Security.checkApiCallAllowed("GET addresses/publickey", request);
+		
+		throw new UnsupportedOperationException();
+	}
+	
+}

src/api/ApiService.java

@@ -25,6 +25,7 @@ public class ApiService {
 	public ApiService() {
 		// resources to register
 		this.resources = new HashSet<Class<?>>();
+		this.resources.add(AddressesResource.class);
 		this.resources.add(BlocksResource.class);
 		this.resources.add(OpenApiResource.class); // swagger
 		this.resources.add(AnnotationPostProcessor.class); // for API resource annotations