93 | *
94 | * @param block
95 | */
96 | private void addBlock(Block block) {
97 | RocksDBUtils.getInstance().putLastBlockHash(block.getHash());
98 | RocksDBUtils.getInstance().putBlock(block);
99 | this.lastBlockHash = block.getHash();
100 | }
101 |
102 |
103 | /**
104 | * 区块链迭代器
105 | */
106 | public class BlockchainIterator {
107 |
108 | private String currentBlockHash;
109 |
110 | private BlockchainIterator(String currentBlockHash) {
111 | this.currentBlockHash = currentBlockHash;
112 | }
113 |
114 | /**
115 | * 是否有下一个区块
116 | *
117 | * @return
118 | */
119 | public boolean hashNext() {
120 | if (StringUtils.isBlank(currentBlockHash)) {
121 | return false;
122 | }
123 | Block lastBlock = RocksDBUtils.getInstance().getBlock(currentBlockHash);
124 | if (lastBlock == null) {
125 | return false;
126 | }
127 | // 创世区块直接放行
128 | if (lastBlock.getPrevBlockHash().length() == 0) {
129 | return true;
130 | }
131 | return RocksDBUtils.getInstance().getBlock(lastBlock.getPrevBlockHash()) != null;
132 | }
133 |
134 |
135 | /**
136 | * 返回区块
137 | *
138 | * @return
139 | */
140 | public Block next() {
141 | Block currentBlock = RocksDBUtils.getInstance().getBlock(currentBlockHash);
142 | if (currentBlock != null) {
143 | this.currentBlockHash = currentBlock.getPrevBlockHash();
144 | return currentBlock;
145 | }
146 | return null;
147 | }
148 | }
149 |
150 | /**
151 | * 获取区块链迭代器
152 | *
153 | * @return
154 | */
155 | public BlockchainIterator getBlockchainIterator() {
156 | return new BlockchainIterator(lastBlockHash);
157 | }
158 |
159 | /**
160 | * 查找所有的 unspent transaction outputs
161 | *
162 | * @return
163 | */
164 | public Map findAllUTXOs() {
165 | Map allSpentTXOs = this.getAllSpentTXOs();
166 | Map allUTXOs = Maps.newHashMap();
167 | // 再次遍历所有区块中的交易输出
168 | for (BlockchainIterator blockchainIterator = this.getBlockchainIterator(); blockchainIterator.hashNext(); ) {
169 | Block block = blockchainIterator.next();
170 | for (Transaction transaction : block.getTransactions()) {
171 |
172 | String txId = Hex.encodeHexString(transaction.getTxId());
173 |
174 | int[] spentOutIndexArray = allSpentTXOs.get(txId);
175 | TXOutput[] txOutputs = transaction.getOutputs();
176 | for (int outIndex = 0; outIndex < txOutputs.length; outIndex++) {
177 | if (spentOutIndexArray != null && ArrayUtils.contains(spentOutIndexArray, outIndex)) {
178 | continue;
179 | }
180 | TXOutput[] UTXOArray = allUTXOs.get(txId);
181 | if (UTXOArray == null) {
182 | UTXOArray = new TXOutput[]{txOutputs[outIndex]};
183 | } else {
184 | UTXOArray = ArrayUtils.add(UTXOArray, txOutputs[outIndex]);
185 | }
186 | allUTXOs.put(txId, UTXOArray);
187 | }
188 | }
189 | }
190 | return allUTXOs;
191 | }
192 |
193 | /**
194 | * 从交易输入中查询区块链中所有已被花费了的交易输出
195 | *
196 | * @return 交易ID以及对应的交易输出下标地址
197 | */
198 | private Map getAllSpentTXOs() {
199 | // 定义TxId ——> spentOutIndex[],存储交易ID与已被花费的交易输出数组索引值
200 | Map spentTXOs = Maps.newHashMap();
201 | for (BlockchainIterator blockchainIterator = this.getBlockchainIterator(); blockchainIterator.hashNext(); ) {
202 | Block block = blockchainIterator.next();
203 |
204 | for (Transaction transaction : block.getTransactions()) {
205 | // 如果是 coinbase 交易,直接跳过,因为它不存在引用前一个区块的交易输出
206 | if (transaction.isCoinbase()) {
207 | continue;
208 | }
209 | for (TXInput txInput : transaction.getInputs()) {
210 | String inTxId = Hex.encodeHexString(txInput.getTxId());
211 | int[] spentOutIndexArray = spentTXOs.get(inTxId);
212 | if (spentOutIndexArray == null) {
213 | spentOutIndexArray = new int[]{txInput.getTxOutputIndex()};
214 | } else {
215 | spentOutIndexArray = ArrayUtils.add(spentOutIndexArray, txInput.getTxOutputIndex());
216 | }
217 | spentTXOs.put(inTxId, spentOutIndexArray);
218 | }
219 | }
220 | }
221 | return spentTXOs;
222 | }
223 |
224 |
225 | /**
226 | * 依据交易ID查询交易信息
227 | *
228 | * @param txId 交易ID
229 | * @return
230 | */
231 | private Transaction findTransaction(byte[] txId) {
232 | for (BlockchainIterator iterator = this.getBlockchainIterator(); iterator.hashNext(); ) {
233 | Block block = iterator.next();
234 | for (Transaction tx : block.getTransactions()) {
235 | if (Arrays.equals(tx.getTxId(), txId)) {
236 | return tx;
237 | }
238 | }
239 | }
240 | throw new RuntimeException("ERROR: Can not found tx by txId ! ");
241 | }
242 |
243 |
244 | /**
245 | * 进行交易签名
246 | *
247 | * @param tx 交易数据
248 | * @param privateKey 私钥
249 | */
250 | public void signTransaction(Transaction tx, BCECPrivateKey privateKey) throws Exception {
251 | // 先来找到这笔新的交易中,交易输入所引用的前面的多笔交易的数据
252 | Map prevTxMap = Maps.newHashMap();
253 | for (TXInput txInput : tx.getInputs()) {
254 | Transaction prevTx = this.findTransaction(txInput.getTxId());
255 | prevTxMap.put(Hex.encodeHexString(txInput.getTxId()), prevTx);
256 | }
257 | tx.sign(privateKey, prevTxMap);
258 | }
259 |
260 | /**
261 | * 交易签名验证
262 | *
263 | * @param tx
264 | */
265 | private boolean verifyTransactions(Transaction tx) {
266 | if (tx.isCoinbase()) {
267 | return true;
268 | }
269 | Map prevTx = Maps.newHashMap();
270 | for (TXInput txInput : tx.getInputs()) {
271 | Transaction transaction = this.findTransaction(txInput.getTxId());
272 | prevTx.put(Hex.encodeHexString(txInput.getTxId()), transaction);
273 | }
274 | try {
275 | return tx.verify(prevTx);
276 | } catch (Exception e) {
277 | log.error("Fail to verify transaction ! transaction invalid ! ", e);
278 | throw new RuntimeException("Fail to verify transaction ! transaction invalid ! ", e);
279 | }
280 | }
281 | }
--------------------------------------------------------------------------------
/src/main/java/one/wangwei/blockchain/transaction/Transaction.java:
--------------------------------------------------------------------------------
1 | package one.wangwei.blockchain.transaction;
2 |
3 | import lombok.AllArgsConstructor;
4 | import lombok.Data;
5 | import lombok.NoArgsConstructor;
6 | import lombok.extern.slf4j.Slf4j;
7 | import one.wangwei.blockchain.block.Blockchain;
8 | import one.wangwei.blockchain.util.BtcAddressUtils;
9 | import one.wangwei.blockchain.util.SerializeUtils;
10 | import one.wangwei.blockchain.wallet.Wallet;
11 | import one.wangwei.blockchain.wallet.WalletUtils;
12 | import org.apache.commons.codec.binary.Hex;
13 | import org.apache.commons.codec.digest.DigestUtils;
14 | import org.apache.commons.lang3.ArrayUtils;
15 | import org.apache.commons.lang3.StringUtils;
16 | import org.bouncycastle.jcajce.provider.asymmetric.ec.BCECPrivateKey;
17 | import org.bouncycastle.jce.ECNamedCurveTable;
18 | import org.bouncycastle.jce.provider.BouncyCastleProvider;
19 | import org.bouncycastle.jce.spec.ECParameterSpec;
20 | import org.bouncycastle.jce.spec.ECPublicKeySpec;
21 | import org.bouncycastle.math.ec.ECPoint;
22 |
23 | import java.math.BigInteger;
24 | import java.security.KeyFactory;
25 | import java.security.PublicKey;
26 | import java.security.Security;
27 | import java.security.Signature;
28 | import java.util.Arrays;
29 | import java.util.Iterator;
30 | import java.util.Map;
31 |
32 | /**
33 | * 交易
34 | *
35 | * @author wangwei
36 | * @date 2017/03/04
37 | */
38 | @Data
39 | @AllArgsConstructor
40 | @NoArgsConstructor
41 | @Slf4j
42 | public class Transaction {
43 |
44 | private static final int SUBSIDY = 10;
45 |
46 | /**
47 | * 交易的Hash
48 | */
49 | private byte[] txId;
50 | /**
51 | * 交易输入
52 | */
53 | private TXInput[] inputs;
54 | /**
55 | * 交易输出
56 | */
57 | private TXOutput[] outputs;
58 | /**
59 | * 创建日期
60 | */
61 | private long createTime;
62 |
63 | /**
64 | * 计算交易信息的Hash值
65 | *
66 | * @return
67 | */
68 | public byte[] hash() {
69 | // 使用序列化的方式对Transaction对象进行深度复制
70 | byte[] serializeBytes = SerializeUtils.serialize(this);
71 | Transaction copyTx = (Transaction) SerializeUtils.deserialize(serializeBytes);
72 | copyTx.setTxId(new byte[]{});
73 | return DigestUtils.sha256(SerializeUtils.serialize(copyTx));
74 | }
75 |
76 | /**
77 | * 创建CoinBase交易
78 | *
79 | * @param to 收账的钱包地址
80 | * @param data 解锁脚本数据
81 | * @return
82 | */
83 | public static Transaction newCoinbaseTX(String to, String data) {
84 | if (StringUtils.isBlank(data)) {
85 | data = String.format("Reward to '%s'", to);
86 | }
87 | // 创建交易输入
88 | TXInput txInput = new TXInput(new byte[]{}, -1, null, data.getBytes());
89 | // 创建交易输出
90 | TXOutput txOutput = TXOutput.newTXOutput(SUBSIDY, to);
91 | // 创建交易
92 | Transaction tx = new Transaction(null, new TXInput[]{txInput},
93 | new TXOutput[]{txOutput}, System.currentTimeMillis());
94 | // 设置交易ID
95 | tx.setTxId(tx.hash());
96 | return tx;
97 | }
98 |
99 | /**
100 | * 是否为 Coinbase 交易
101 | *
102 | * @return
103 | */
104 | public boolean isCoinbase() {
105 | return this.getInputs().length == 1
106 | && this.getInputs()[0].getTxId().length == 0
107 | && this.getInputs()[0].getTxOutputIndex() == -1;
108 | }
109 |
110 |
111 | /**
112 | * 从 from 向 to 支付一定的 amount 的金额
113 | *
114 | * @param from 支付钱包地址
115 | * @param to 收款钱包地址
116 | * @param amount 交易金额
117 | * @param blockchain 区块链
118 | * @return
119 | */
120 | public static Transaction newUTXOTransaction(String from, String to, int amount, Blockchain blockchain) throws Exception {
121 | // 获取钱包
122 | Wallet senderWallet = WalletUtils.getInstance().getWallet(from);
123 | byte[] pubKey = senderWallet.getPublicKey();
124 | byte[] pubKeyHash = BtcAddressUtils.ripeMD160Hash(pubKey);
125 |
126 | SpendableOutputResult result = new UTXOSet(blockchain).findSpendableOutputs(pubKeyHash, amount);
127 | int accumulated = result.getAccumulated();
128 | Map unspentOuts = result.getUnspentOuts();
129 |
130 | if (accumulated < amount) {
131 | log.error("ERROR: Not enough funds ! accumulated=" + accumulated + ", amount=" + amount);
132 | throw new RuntimeException("ERROR: Not enough funds ! ");
133 | }
134 | Iterator> iterator = unspentOuts.entrySet().iterator();
135 |
136 | TXInput[] txInputs = {};
137 | while (iterator.hasNext()) {
138 | Map.Entry entry = iterator.next();
139 | String txIdStr = entry.getKey();
140 | int[] outIds = entry.getValue();
141 | byte[] txId = Hex.decodeHex(txIdStr);
142 | for (int outIndex : outIds) {
143 | txInputs = ArrayUtils.add(txInputs, new TXInput(txId, outIndex, null, pubKey));
144 | }
145 | }
146 |
147 | TXOutput[] txOutput = {};
148 | txOutput = ArrayUtils.add(txOutput, TXOutput.newTXOutput(amount, to));
149 | if (accumulated > amount) {
150 | txOutput = ArrayUtils.add(txOutput, TXOutput.newTXOutput((accumulated - amount), from));
151 | }
152 |
153 | Transaction newTx = new Transaction(null, txInputs, txOutput, System.currentTimeMillis());
154 | newTx.setTxId(newTx.hash());
155 |
156 | // 进行交易签名
157 | blockchain.signTransaction(newTx, senderWallet.getPrivateKey());
158 |
159 | return newTx;
160 | }
161 |
162 |
163 | /**
164 | * 创建用于签名的交易数据副本,交易输入的 signature 和 pubKey 需要设置为null
165 | *
166 | * @return
167 | */
168 | public Transaction trimmedCopy() {
169 | TXInput[] tmpTXInputs = new TXInput[this.getInputs().length];
170 | for (int i = 0; i < this.getInputs().length; i++) {
171 | TXInput txInput = this.getInputs()[i];
172 | tmpTXInputs[i] = new TXInput(txInput.getTxId(), txInput.getTxOutputIndex(), null, null);
173 | }
174 |
175 | TXOutput[] tmpTXOutputs = new TXOutput[this.getOutputs().length];
176 | for (int i = 0; i < this.getOutputs().length; i++) {
177 | TXOutput txOutput = this.getOutputs()[i];
178 | tmpTXOutputs[i] = new TXOutput(txOutput.getValue(), txOutput.getPubKeyHash());
179 | }
180 |
181 | return new Transaction(this.getTxId(), tmpTXInputs, tmpTXOutputs, this.getCreateTime());
182 | }
183 |
184 |
185 | /**
186 | * 签名
187 | *
188 | * @param privateKey 私钥
189 | * @param prevTxMap 前面多笔交易集合
190 | */
191 | public void sign(BCECPrivateKey privateKey, Map prevTxMap) throws Exception {
192 | // coinbase 交易信息不需要签名,因为它不存在交易输入信息
193 | if (this.isCoinbase()) {
194 | return;
195 | }
196 | // 再次验证一下交易信息中的交易输入是否正确,也就是能否查找对应的交易数据
197 | for (TXInput txInput : this.getInputs()) {
198 | if (prevTxMap.get(Hex.encodeHexString(txInput.getTxId())) == null) {
199 | throw new RuntimeException("ERROR: Previous transaction is not correct");
200 | }
201 | }
202 |
203 | // 创建用于签名的交易信息的副本
204 | Transaction txCopy = this.trimmedCopy();
205 |
206 | Security.addProvider(new BouncyCastleProvider());
207 | Signature ecdsaSign = Signature.getInstance("SHA256withECDSA", BouncyCastleProvider.PROVIDER_NAME);
208 | ecdsaSign.initSign(privateKey);
209 |
210 | for (int i = 0; i < txCopy.getInputs().length; i++) {
211 | TXInput txInputCopy = txCopy.getInputs()[i];
212 | // 获取交易输入TxID对应的交易数据
213 | Transaction prevTx = prevTxMap.get(Hex.encodeHexString(txInputCopy.getTxId()));
214 | // 获取交易输入所对应的上一笔交易中的交易输出
215 | TXOutput prevTxOutput = prevTx.getOutputs()[txInputCopy.getTxOutputIndex()];
216 | txInputCopy.setPubKey(prevTxOutput.getPubKeyHash());
217 | txInputCopy.setSignature(null);
218 | // 得到要签名的数据,即交易ID
219 | txCopy.setTxId(txCopy.hash());
220 | txInputCopy.setPubKey(null);
221 |
222 | // 对整个交易信息仅进行签名,即对交易ID进行签名
223 | ecdsaSign.update(txCopy.getTxId());
224 | byte[] signature = ecdsaSign.sign();
225 |
226 | // 将整个交易数据的签名赋值给交易输入,因为交易输入需要包含整个交易信息的签名
227 | // 注意是将得到的签名赋值给原交易信息中的交易输入
228 | this.getInputs()[i].setSignature(signature);
229 | }
230 | }
231 |
232 |
233 | /**
234 | * 验证交易信息
235 | *
236 | * @param prevTxMap 前面多笔交易集合
237 | * @return
238 | */
239 | public boolean verify(Map prevTxMap) throws Exception {
240 | // coinbase 交易信息不需要签名,也就无需验证
241 | if (this.isCoinbase()) {
242 | return true;
243 | }
244 |
245 | // 再次验证一下交易信息中的交易输入是否正确,也就是能否查找对应的交易数据
246 | for (TXInput txInput : this.getInputs()) {
247 | if (prevTxMap.get(Hex.encodeHexString(txInput.getTxId())) == null) {
248 | throw new RuntimeException("ERROR: Previous transaction is not correct");
249 | }
250 | }
251 |
252 | // 创建用于签名验证的交易信息的副本
253 | Transaction txCopy = this.trimmedCopy();
254 |
255 | Security.addProvider(new BouncyCastleProvider());
256 | ECParameterSpec ecParameters = ECNamedCurveTable.getParameterSpec("secp256k1");
257 | KeyFactory keyFactory = KeyFactory.getInstance("ECDSA", BouncyCastleProvider.PROVIDER_NAME);
258 | Signature ecdsaVerify = Signature.getInstance("SHA256withECDSA", BouncyCastleProvider.PROVIDER_NAME);
259 |
260 | for (int i = 0; i < this.getInputs().length; i++) {
261 | TXInput txInput = this.getInputs()[i];
262 | // 获取交易输入TxID对应的交易数据
263 | Transaction prevTx = prevTxMap.get(Hex.encodeHexString(txInput.getTxId()));
264 | // 获取交易输入所对应的上一笔交易中的交易输出
265 | TXOutput prevTxOutput = prevTx.getOutputs()[txInput.getTxOutputIndex()];
266 |
267 | TXInput txInputCopy = txCopy.getInputs()[i];
268 | txInputCopy.setSignature(null);
269 | txInputCopy.setPubKey(prevTxOutput.getPubKeyHash());
270 | // 得到要签名的数据,即交易ID
271 | txCopy.setTxId(txCopy.hash());
272 | txInputCopy.setPubKey(null);
273 |
274 | // 使用椭圆曲线 x,y 点去生成公钥Key
275 | BigInteger x = new BigInteger(1, Arrays.copyOfRange(txInput.getPubKey(), 1, 33));
276 | BigInteger y = new BigInteger(1, Arrays.copyOfRange(txInput.getPubKey(), 33, 65));
277 | ECPoint ecPoint = ecParameters.getCurve().createPoint(x, y);
278 |
279 | ECPublicKeySpec keySpec = new ECPublicKeySpec(ecPoint, ecParameters);
280 | PublicKey publicKey = keyFactory.generatePublic(keySpec);
281 | ecdsaVerify.initVerify(publicKey);
282 | ecdsaVerify.update(txCopy.getTxId());
283 | if (!ecdsaVerify.verify(txInput.getSignature())) {
284 | return false;
285 | }
286 | }
287 | return true;
288 | }
289 | }
290 |
--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
1 | Apache License
2 | Version 2.0, January 2004
3 | http://www.apache.org/licenses/
4 |
5 | TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
6 |
7 | 1. Definitions.
8 |
9 | "License" shall mean the terms and conditions for use, reproduction,
10 | and distribution as defined by Sections 1 through 9 of this document.
11 |
12 | "Licensor" shall mean the copyright owner or entity authorized by
13 | the copyright owner that is granting the License.
14 |
15 | "Legal Entity" shall mean the union of the acting entity and all
16 | other entities that control, are controlled by, or are under common
17 | control with that entity. For the purposes of this definition,
18 | "control" means (i) the power, direct or indirect, to cause the
19 | direction or management of such entity, whether by contract or
20 | otherwise, or (ii) ownership of fifty percent (50%) or more of the
21 | outstanding shares, or (iii) beneficial ownership of such entity.
22 |
23 | "You" (or "Your") shall mean an individual or Legal Entity
24 | exercising permissions granted by this License.
25 |
26 | "Source" form shall mean the preferred form for making modifications,
27 | including but not limited to software source code, documentation
28 | source, and configuration files.
29 |
30 | "Object" form shall mean any form resulting from mechanical
31 | transformation or translation of a Source form, including but
32 | not limited to compiled object code, generated documentation,
33 | and conversions to other media types.
34 |
35 | "Work" shall mean the work of authorship, whether in Source or
36 | Object form, made available under the License, as indicated by a
37 | copyright notice that is included in or attached to the work
38 | (an example is provided in the Appendix below).
39 |
40 | "Derivative Works" shall mean any work, whether in Source or Object
41 | form, that is based on (or derived from) the Work and for which the
42 | editorial revisions, annotations, elaborations, or other modifications
43 | represent, as a whole, an original work of authorship. For the purposes
44 | of this License, Derivative Works shall not include works that remain
45 | separable from, or merely link (or bind by name) to the interfaces of,
46 | the Work and Derivative Works thereof.
47 |
48 | "Contribution" shall mean any work of authorship, including
49 | the original version of the Work and any modifications or additions
50 | to that Work or Derivative Works thereof, that is intentionally
51 | submitted to Licensor for inclusion in the Work by the copyright owner
52 | or by an individual or Legal Entity authorized to submit on behalf of
53 | the copyright owner. For the purposes of this definition, "submitted"
54 | means any form of electronic, verbal, or written communication sent
55 | to the Licensor or its representatives, including but not limited to
56 | communication on electronic mailing lists, source code control systems,
57 | and issue tracking systems that are managed by, or on behalf of, the
58 | Licensor for the purpose of discussing and improving the Work, but
59 | excluding communication that is conspicuously marked or otherwise
60 | designated in writing by the copyright owner as "Not a Contribution."
61 |
62 | "Contributor" shall mean Licensor and any individual or Legal Entity
63 | on behalf of whom a Contribution has been received by Licensor and
64 | subsequently incorporated within the Work.
65 |
66 | 2. Grant of Copyright License. Subject to the terms and conditions of
67 | this License, each Contributor hereby grants to You a perpetual,
68 | worldwide, non-exclusive, no-charge, royalty-free, irrevocable
69 | copyright license to reproduce, prepare Derivative Works of,
70 | publicly display, publicly perform, sublicense, and distribute the
71 | Work and such Derivative Works in Source or Object form.
72 |
73 | 3. Grant of Patent License. Subject to the terms and conditions of
74 | this License, each Contributor hereby grants to You a perpetual,
75 | worldwide, non-exclusive, no-charge, royalty-free, irrevocable
76 | (except as stated in this section) patent license to make, have made,
77 | use, offer to sell, sell, import, and otherwise transfer the Work,
78 | where such license applies only to those patent claims licensable
79 | by such Contributor that are necessarily infringed by their
80 | Contribution(s) alone or by combination of their Contribution(s)
81 | with the Work to which such Contribution(s) was submitted. If You
82 | institute patent litigation against any entity (including a
83 | cross-claim or counterclaim in a lawsuit) alleging that the Work
84 | or a Contribution incorporated within the Work constitutes direct
85 | or contributory patent infringement, then any patent licenses
86 | granted to You under this License for that Work shall terminate
87 | as of the date such litigation is filed.
88 |
89 | 4. Redistribution. You may reproduce and distribute copies of the
90 | Work or Derivative Works thereof in any medium, with or without
91 | modifications, and in Source or Object form, provided that You
92 | meet the following conditions:
93 |
94 | (a) You must give any other recipients of the Work or
95 | Derivative Works a copy of this License; and
96 |
97 | (b) You must cause any modified files to carry prominent notices
98 | stating that You changed the files; and
99 |
100 | (c) You must retain, in the Source form of any Derivative Works
101 | that You distribute, all copyright, patent, trademark, and
102 | attribution notices from the Source form of the Work,
103 | excluding those notices that do not pertain to any part of
104 | the Derivative Works; and
105 |
106 | (d) If the Work includes a "NOTICE" text file as part of its
107 | distribution, then any Derivative Works that You distribute must
108 | include a readable copy of the attribution notices contained
109 | within such NOTICE file, excluding those notices that do not
110 | pertain to any part of the Derivative Works, in at least one
111 | of the following places: within a NOTICE text file distributed
112 | as part of the Derivative Works; within the Source form or
113 | documentation, if provided along with the Derivative Works; or,
114 | within a display generated by the Derivative Works, if and
115 | wherever such third-party notices normally appear. The contents
116 | of the NOTICE file are for informational purposes only and
117 | do not modify the License. You may add Your own attribution
118 | notices within Derivative Works that You distribute, alongside
119 | or as an addendum to the NOTICE text from the Work, provided
120 | that such additional attribution notices cannot be construed
121 | as modifying the License.
122 |
123 | You may add Your own copyright statement to Your modifications and
124 | may provide additional or different license terms and conditions
125 | for use, reproduction, or distribution of Your modifications, or
126 | for any such Derivative Works as a whole, provided Your use,
127 | reproduction, and distribution of the Work otherwise complies with
128 | the conditions stated in this License.
129 |
130 | 5. Submission of Contributions. Unless You explicitly state otherwise,
131 | any Contribution intentionally submitted for inclusion in the Work
132 | by You to the Licensor shall be under the terms and conditions of
133 | this License, without any additional terms or conditions.
134 | Notwithstanding the above, nothing herein shall supersede or modify
135 | the terms of any separate license agreement you may have executed
136 | with Licensor regarding such Contributions.
137 |
138 | 6. Trademarks. This License does not grant permission to use the trade
139 | names, trademarks, service marks, or product names of the Licensor,
140 | except as required for reasonable and customary use in describing the
141 | origin of the Work and reproducing the content of the NOTICE file.
142 |
143 | 7. Disclaimer of Warranty. Unless required by applicable law or
144 | agreed to in writing, Licensor provides the Work (and each
145 | Contributor provides its Contributions) on an "AS IS" BASIS,
146 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
147 | implied, including, without limitation, any warranties or conditions
148 | of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
149 | PARTICULAR PURPOSE. You are solely responsible for determining the
150 | appropriateness of using or redistributing the Work and assume any
151 | risks associated with Your exercise of permissions under this License.
152 |
153 | 8. Limitation of Liability. In no event and under no legal theory,
154 | whether in tort (including negligence), contract, or otherwise,
155 | unless required by applicable law (such as deliberate and grossly
156 | negligent acts) or agreed to in writing, shall any Contributor be
157 | liable to You for damages, including any direct, indirect, special,
158 | incidental, or consequential damages of any character arising as a
159 | result of this License or out of the use or inability to use the
160 | Work (including but not limited to damages for loss of goodwill,
161 | work stoppage, computer failure or malfunction, or any and all
162 | other commercial damages or losses), even if such Contributor
163 | has been advised of the possibility of such damages.
164 |
165 | 9. Accepting Warranty or Additional Liability. While redistributing
166 | the Work or Derivative Works thereof, You may choose to offer,
167 | and charge a fee for, acceptance of support, warranty, indemnity,
168 | or other liability obligations and/or rights consistent with this
169 | License. However, in accepting such obligations, You may act only
170 | on Your own behalf and on Your sole responsibility, not on behalf
171 | of any other Contributor, and only if You agree to indemnify,
172 | defend, and hold each Contributor harmless for any liability
173 | incurred by, or claims asserted against, such Contributor by reason
174 | of your accepting any such warranty or additional liability.
175 |
176 | END OF TERMS AND CONDITIONS
177 |
178 | APPENDIX: How to apply the Apache License to your work.
179 |
180 | To apply the Apache License to your work, attach the following
181 | boilerplate notice, with the fields enclosed by brackets "{}"
182 | replaced with your own identifying information. (Don't include
183 | the brackets!) The text should be enclosed in the appropriate
184 | comment syntax for the file format. We also recommend that a
185 | file or class name and description of purpose be included on the
186 | same "printed page" as the copyright notice for easier
187 | identification within third-party archives.
188 |
189 | Copyright {yyyy} {name of copyright owner}
190 |
191 | Licensed under the Apache License, Version 2.0 (the "License");
192 | you may not use this file except in compliance with the License.
193 | You may obtain a copy of the License at
194 |
195 | http://www.apache.org/licenses/LICENSE-2.0
196 |
197 | Unless required by applicable law or agreed to in writing, software
198 | distributed under the License is distributed on an "AS IS" BASIS,
199 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
200 | See the License for the specific language governing permissions and
201 | limitations under the License.
202 |
--------------------------------------------------------------------------------